---
type: "firecrawl-provider"
description: "Find a verified work email, and enrich a person or a company."
use_when: "Find a verified work email or a phone number, or enrich one person.\n\nEnrich one company from a domain, a name, a profile URL, or a SIREN number."
categories: "People"
capabilities: 3
credits_per_record: 25
---
# Datagma on Firecrawl Alexandria

Find a verified work email, and enrich a person or a company.

- Categories: People
- Category index: [People category](https://alexandria.firecrawl.dev/agents/categories/people)
- Provider key: `datagma`
- Access: Firecrawl credits
- Cost (Work email finder): 25 credits per record
- Cost (Person enrichment): 25 credits per record
- Cost (Company enrichment): 25 credits per record

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/datagma)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/datagma/openapi.json)

## Capabilities

- [Work email finder](https://alexandria.firecrawl.dev/agents/providers/datagma/people/email-find): email is empty on a miss. status Most Probable is an unverified catch-all guess and is not billed.
- [Person enrichment](https://alexandria.firecrawl.dev/agents/providers/datagma/people/enrich): person.basic is the matched person. person.data is the full profile when personFull is set. company is the employer when Datagma has it. Gender, date of birth, age, and employee lists are removed.
- [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/datagma/companies/enrich): company.basic is name, website, industry, size, location, and profile URL. premium, full, and french are present when requested and found. Employee lists are removed.

## 1. Choose this provider when

Find a verified work email or a phone number, or enrich one person.

Enrich one company from a domain, a name, a profile URL, or a SIREN number.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "datagma",
  "capability": "people/email-find",
  "options": {
    "fullName": "<fullName>",
    "company": "<company>"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `fullName` (string): Full name. Use this or firstName and lastName. Example: `<fullName>`
- `firstName` (string): Given name. Send with lastName. Example: `<firstName>`
- `lastName` (string): Family name. Send with firstName. Example: `<lastName>`
- `company` (string): Employer domain, such as algolia.com, or company name. A domain avoids namesakes. Example: `<company>`
- `linkedInSlug` (string): Company profile URL, such as https://www.linkedin.com/company/algolia, when the domain is unknown. Example: `<linkedInSlug>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "datagma",
    capability: "people/email-find",
    options: {
      fullName: "<fullName>",
      company: "<company>",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "datagma",
  "capability": "people/email-find",
  "options": {
    "fullName": "<fullName>",
    "company": "<company>"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "datagma",
    "capability": "people/email-find",
    "options": {
      "fullName": "<fullName>",
      "company": "<company>"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'datagma/people/email-find' \
  --options '{"fullName":"<fullName>","company":"<company>"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "datagma",
  "capability": "people/email-find",
  "options": {
    "fullName": "<fullName>",
    "company": "<company>"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "datagma",
  "capability": "people/email-find",
  "options": {
    "fullName": "<fullName>",
    "company": "<company>"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "email": "<email>",
  "emailDomain": "<emailDomain>",
  "status": "<status>",
  "patterns": [],
  "mxfound": false,
  "smtpCheck": false,
  "cachAll": false
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Work email finder

- Capability: `people/email-find`
- Description: email is empty on a miss. status Most Probable is an unverified catch-all guess and is not billed.
- Instructions: Find one verified work email from a name and an employer domain, company name, or company profile URL. 25 credits when a verified email comes back. A miss, and a catch-all guess Datagma marks Most Probable, cost nothing. Use people/enrich for the profile rather than the email.
- Cost: 25 credits per record
- Capability file: [Work email finder](https://alexandria.firecrawl.dev/agents/providers/datagma/people/email-find)

Accepted options:
- `fullName` (string): Full name. Use this or firstName and lastName. Example: `<fullName>`
- `firstName` (string): Given name. Send with lastName. Example: `<firstName>`
- `lastName` (string): Family name. Send with firstName. Example: `<lastName>`
- `company` (string): Employer domain, such as algolia.com, or company name. A domain avoids namesakes. Example: `<company>`
- `linkedInSlug` (string): Company profile URL, such as https://www.linkedin.com/company/algolia, when the domain is unknown. Example: `<linkedInSlug>`

Response schema example:
```json
{
  "email": "<email>",
  "emailDomain": "<emailDomain>",
  "status": "<status>",
  "patterns": [],
  "mxfound": false,
  "smtpCheck": false,
  "cachAll": false
}
```

### Person enrichment

- Capability: `people/enrich`
- Description: person.basic is the matched person. person.data is the full profile when personFull is set. company is the employer when Datagma has it. Gender, date of birth, age, and employee lists are removed.
- Instructions: Enrich one person from a professional profile URL, a work email, or a name plus employer. 25 credits when Datagma matches a person. A miss costs nothing. Use people/email-find for a verified email.
- Cost: 25 credits per record
- Capability file: [Person enrichment](https://alexandria.firecrawl.dev/agents/providers/datagma/people/enrich)

Accepted options:
- `data` (string, required): Professional profile URL or work email. With fullName, or firstName and lastName, this is the employer name or domain instead. Example: `<data>`
- `fullName` (string): Full name, with data set to the employer. Example: `<fullName>`
- `firstName` (string): Given name. Send with lastName and data set to the employer. Example: `<firstName>`
- `lastName` (string): Family name. Send with firstName. Example: `<lastName>`
- `countryCode` (string): Country hint that reduces namesakes, such as FR. Example: `<countryCode>`
- `personFull` (boolean): Include experience, education, and the rest of the full profile. Example: `false`
- `companyPremium` (boolean): Include the employer's company-profile fields. Example: `false`
- `companyFull` (boolean): Include the employer's funding and financial fields. Example: `false`
- `companyFrench` (boolean): Include SIREN directory fields when the employer is French. Example: `false`

Response schema example:
```json
{
  "person": {},
  "company": {},
  "email": {},
  "creditBurn": "<creditBurn>"
}
```

### Company enrichment

- Capability: `companies/enrich`
- Description: company.basic is name, website, industry, size, location, and profile URL. premium, full, and french are present when requested and found. Employee lists are removed.
- Instructions: Enrich one company from its domain, name, company profile URL, or French SIREN number. 25 credits when Datagma matches a company. A miss costs nothing. Set companyPremium and companyFull for the most fields.
- Cost: 25 credits per record
- Capability file: [Company enrichment](https://alexandria.firecrawl.dev/agents/providers/datagma/companies/enrich)

Accepted options:
- `data` (string, required): Company domain, website, name, company profile URL, or French SIREN number. Example: `<data>`
- `companyKeyword` (string): Disambiguates a company name: part of the address, a founder, or the industry. Example: `<companyKeyword>`
- `countryCode` (string): Country hint that reduces namesakes, such as FR. Example: `<countryCode>`
- `companyPremium` (boolean): Include company-profile fields. Defaults to true, since Datagma finds no company without it; the price is the same. Example: `false`
- `companyFull` (boolean): Include funding and financial fields. Example: `false`
- `companyFrench` (boolean): Include SIREN directory fields for a French company. Example: `false`

Response schema example:
```json
{
  "company": {},
  "creditBurn": "<creditBurn>"
}
```