---
type: "firecrawl-provider"
description: "Person and company enrichment with separate tier and contact products."
use_when: "Person enrichment.\n\nCompany enrichment."
categories: "People"
capabilities: 6
pricing: "20–160 credits per billed unit; see each capability for its unit and maximum."
---
# Data Legion on Firecrawl Alexandria

Person and company enrichment with separate tier and contact products.

- Categories: People
- Category index: [People category](https://alexandria.firecrawl.dev/agents/categories/people)
- Provider key: `datalegion`
- Access: Firecrawl credits
- Cost (Person enrichment (base-no-contact)): 20 credits per successful enrichment call
- Cost (Person enrichment (base-with-contact)): 100 credits per successful enrichment call
- Cost (Person enrichment (premium-no-contact)): 40 credits per successful enrichment call
- Cost (Person enrichment (premium-with-contact)): 160 credits per successful enrichment call
- Cost (Company enrichment (base)): 20 credits per successful enrichment call
- Cost (Company enrichment (premium)): 40 credits per successful enrichment call

## More

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

## Capabilities

- [Person enrichment (base-no-contact)](https://alexandria.firecrawl.dev/agents/providers/datalegion/people/enrich-base-no-contact): Matches contain a nested person record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- [Person enrichment (base-with-contact)](https://alexandria.firecrawl.dev/agents/providers/datalegion/people/enrich-base-with-contact): Matches contain a nested person record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- [Person enrichment (premium-no-contact)](https://alexandria.firecrawl.dev/agents/providers/datalegion/people/enrich-premium-no-contact): Matches contain a nested person record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- [Person enrichment (premium-with-contact)](https://alexandria.firecrawl.dev/agents/providers/datalegion/people/enrich-premium-with-contact): Matches contain a nested person record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- [Company enrichment (base)](https://alexandria.firecrawl.dev/agents/providers/datalegion/companies/enrich-base): Matches contain a nested company record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- [Company enrichment (premium)](https://alexandria.firecrawl.dev/agents/providers/datalegion/companies/enrich-premium): Matches contain a nested company record. Optional fields depend on entitlement and field selection. The outer total reports matches found.

## 1. Choose this provider when

Person enrichment.

Company enrichment.

## 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": "datalegion",
  "capability": "people/enrich-base-no-contact",
  "options": {
    "social_url": "https://www.linkedin.com/in/janedoe"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `email` (string): Email address (will be normalized) Example: `<email>`
- `email_hash` (string): SHA-256 (64 chars), SHA-1 (40 chars), or MD5 (32 chars) hash of normalized email address (for privacy) Example: `<email_hash>`
- `phone` (string): Phone number (will be normalized to E.164) Example: `<phone>`
- `linkedin_id` (string): LinkedIn numeric ID Example: `<linkedin_id>`
- `social_url` (string): Social profile URL (LinkedIn, Twitter/X, GitHub, Facebook - will be normalized and detected) Example: `<social_url>`
- `legion_id` (string): Legion ID (exact match) Example: `<legion_id>`
- `full_name` (string): Full name (will be normalized) Example: `<full_name>`
- `first_name` (string): First name (will be normalized) Example: `<first_name>`
- `last_name` (string): Last name (will be normalized) Example: `<last_name>`
- `address` (string): Full address string (will be parsed to extract city, state, postal_code, and country) Example: `<address>`
- `city` (string): City name Example: `<city>`
- `state` (string): State name or code Example: `<state>`
- `country` (string): Country name or code Example: `<country>`
- `postal_code` (string): Postal/ZIP code Example: `<postal_code>`
- `job_title` (string): Job title Example: `<job_title>`
- `company` (string): Company name, website, or social URL Example: `<company>`
- `school` (string): School name, website, or social URL Example: `<school>`
- `birth_date` (string): Birth date for matching or narrowing name-based results (YYYY-MM-DD, YYYY-MM, or YYYY). Can be used as name + birth_date lookup or as a qualifier on other name-based combos. Example: `<birth_date>`
- `min_confidence` (string): Minimum match confidence level to include in results: 'high', 'moderate', or 'low'. Matches below this threshold will be filtered out. Example: `high`
- `titlecase` (boolean): If true, format text fields in title case (names, job titles, company names, locations, skills, headlines). Raw fields, IDs, URLs, codes, and confidence fields are excluded. Example: `false`
- `required_fields` (string): Comma-separated list of fields that must be present, else the match is filtered out. Supports top-level fields ('work_email,phones'), a non-empty list subfield ('emails.type'), or a subfield equal to a value ('emails.type:personal', 'phones.type:mobile', 'socials.network:linkedin'). Unknown field names or out-of-range enum values return HTTP 400. Example: `<required_fields>`
- `include_fields` (string): Comma-separated list of fields to include in response. If omitted, all fields are returned. Example: `<include_fields>`
- `exclude_fields` (string): Comma-separated list of fields to exclude from response. Applied after include_fields filter. Example: `<exclude_fields>`
- `pretty_print` (boolean): If true, pretty-print JSON response with indentation. Example: `false`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "datalegion",
    capability: "people/enrich-base-no-contact",
    options: {
      social_url: "https://www.linkedin.com/in/janedoe",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "datalegion",
  "capability": "people/enrich-base-no-contact",
  "options": {
    "social_url": "https://www.linkedin.com/in/janedoe"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "datalegion",
    "capability": "people/enrich-base-no-contact",
    "options": {
      "social_url": "https://www.linkedin.com/in/janedoe"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'datalegion/people/enrich-base-no-contact' \
  --options '{"social_url":"https://www.linkedin.com/in/janedoe"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "datalegion",
  "capability": "people/enrich-base-no-contact",
  "options": {
    "social_url": "https://www.linkedin.com/in/janedoe"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "datalegion",
  "capability": "people/enrich-base-no-contact",
  "options": {
    "social_url": "https://www.linkedin.com/in/janedoe"
  }
}
```

## 6. Response data

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

```json
{
  "matches": [
    {
      "person": {
        "legion_id": "a1b2c3d4-e5f6-5a1b-8c3d-4e5f6a1b2c3d",
        "full_name": "jane marie doe jr",
        "first_name": "jane",
        "middle_name": "marie",
        "middle_initial": "m",
        "last_name": "doe",
        "last_initial": "d",
        "suffix": "jr",
        "prefix": "dr",
        "job_title": "senior product manager",
        "company_legion_id": "b2c3d4e5-f6a1-5b2c-9d4e-5f6a1b2c3d4e",
        "company_name": "tech company",
        "company_domain": "techcompany.com",
        "company_linkedin_url": "https://www.linkedin.com/company/techcompany",
        "company_linkedin_id": "12345678",
        "company_industry": "technology, information and internet",
        "company_size": "1001-5000",
        "linkedin_url": "https://www.linkedin.com/in/janedoe",
        "linkedin_id": "556230244",
        "headline": {
          "cleaned": "senior product manager at tech company"
        },
        "summary": {
          "cleaned": "experienced product leader with 10+ years in technology..."
        },
        "skills": [
          {
            "cleaned": "project management"
          },
          {
            "cleaned": "data analysis"
          }
        ],
        "languages": [
          {
            "cleaned": "english",
            "proficiency": "native"
          },
          {
            "cleaned": "spanish",
            "proficiency": "fluent"
          }
        ],
        "experience": [
          {
            "title": {
              "cleaned": "senior product manager"
            },
            "organization": {
              "legion_id": "b2c3d4e5-f6a1-5b2c-9d4e-5f6a1b2c3d4e",
              "name": {
                "cleaned": "tech company inc"
              },
              "website": "techcompany.com",
              "linkedin_url": "https://www.linkedin.com/company/tech-company-inc",
              "linkedin_id": "12345678",
              "industry": "technology, information and internet",
              "size": "1001-5000"
            },
            "start_date": "2020-06-01",
            "end_date": null,
            "current": true,
            "tenure_months": 68,
            "description": {
              "cleaned": "leading product strategy for enterprise platform..."
            }
          },
          {
            "title": {
              "cleaned": "product manager"
            },
            "organization": {
              "legion_id": null,
              "name": {
                "cleaned": "startup corp"
              },
              "website": null,
              "linkedin_url": null,
              "linkedin_id": null,
              "industry": null,
              "size": null
            },
            "start_date": "2017-03-01",
            "end_date": "2020-05-31",
            "current": false,
            "tenure_months": 38,
            "description": {
              "cleaned": "managed b2b saas product from concept to launch..."
            }
          }
        ],
        "education": [
          {
            "organization": {
              "name": {
                "cleaned": "stanford university"
              },
              "website": "stanford.edu",
              "linkedin_url": "https://www.linkedin.com/school/stanford-university"
            },
            "degree": {
              "cleaned": "master of business administration"
            },
            "field_of_study": {
              "cleaned": "business administration"
            },
            "start_date": "2015",
            "end_date": "2017",
            "current": false
          },
          {
            "organization": {
              "name": {
                "cleaned": "university of california berkeley"
              },
              "website": null,
              "linkedin_url": null
            },
            "degree": {
              "cleaned": "bachelor of science in computer science"
            },
            "field_of_study": {
              "cleaned": "computer science"
            },
            "start_date": "2003",
            "end_date": "2007",
            "current": false
          }
        ],
        "socials": [
          {
            "network": "linkedin",
            "url": "https://www.linkedin.com/in/janedoe",
            "id": null,
            "username": "janedoe",
            "current": true
          },
          {
            "network": "github",
            "url": "https://github.com/janedoe",
            "id": "12345678",
            "username": "janedoe",
            "current": true
          }
        ],
        "build_version": "1.5.0_2026-10-15"
      },
      "match_metadata": {
        "matched_on": [
          "social_url"
        ],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}
```

## API reference-derived contract

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

### Person enrichment (base-no-contact)

- Capability: `people/enrich-base-no-contact`
- Description: Matches contain a nested person record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- Instructions: Match a known person using identifiers with the base-no-contact product. Contact entitlement comes from the dedicated credential, never from field projection.
- Cost: 20 credits per successful enrichment call
- Capability file: [Person enrichment (base-no-contact)](https://alexandria.firecrawl.dev/agents/providers/datalegion/people/enrich-base-no-contact)

Accepted options:
- `email` (string): Email address (will be normalized) Example: `<email>`
- `email_hash` (string): SHA-256 (64 chars), SHA-1 (40 chars), or MD5 (32 chars) hash of normalized email address (for privacy) Example: `<email_hash>`
- `phone` (string): Phone number (will be normalized to E.164) Example: `<phone>`
- `linkedin_id` (string): LinkedIn numeric ID Example: `<linkedin_id>`
- `social_url` (string): Social profile URL (LinkedIn, Twitter/X, GitHub, Facebook - will be normalized and detected) Example: `<social_url>`
- `legion_id` (string): Legion ID (exact match) Example: `<legion_id>`
- `full_name` (string): Full name (will be normalized) Example: `<full_name>`
- `first_name` (string): First name (will be normalized) Example: `<first_name>`
- `last_name` (string): Last name (will be normalized) Example: `<last_name>`
- `address` (string): Full address string (will be parsed to extract city, state, postal_code, and country) Example: `<address>`
- `city` (string): City name Example: `<city>`
- `state` (string): State name or code Example: `<state>`
- `country` (string): Country name or code Example: `<country>`
- `postal_code` (string): Postal/ZIP code Example: `<postal_code>`
- `job_title` (string): Job title Example: `<job_title>`
- `company` (string): Company name, website, or social URL Example: `<company>`
- `school` (string): School name, website, or social URL Example: `<school>`
- `birth_date` (string): Birth date for matching or narrowing name-based results (YYYY-MM-DD, YYYY-MM, or YYYY). Can be used as name + birth_date lookup or as a qualifier on other name-based combos. Example: `<birth_date>`
- `min_confidence` (string): Minimum match confidence level to include in results: 'high', 'moderate', or 'low'. Matches below this threshold will be filtered out. Example: `high`
- `titlecase` (boolean): If true, format text fields in title case (names, job titles, company names, locations, skills, headlines). Raw fields, IDs, URLs, codes, and confidence fields are excluded. Example: `false`
- `required_fields` (string): Comma-separated list of fields that must be present, else the match is filtered out. Supports top-level fields ('work_email,phones'), a non-empty list subfield ('emails.type'), or a subfield equal to a value ('emails.type:personal', 'phones.type:mobile', 'socials.network:linkedin'). Unknown field names or out-of-range enum values return HTTP 400. Example: `<required_fields>`
- `include_fields` (string): Comma-separated list of fields to include in response. If omitted, all fields are returned. Example: `<include_fields>`
- `exclude_fields` (string): Comma-separated list of fields to exclude from response. Applied after include_fields filter. Example: `<exclude_fields>`
- `pretty_print` (boolean): If true, pretty-print JSON response with indentation. Example: `false`

Response schema example:
```json
{
  "matches": [
    {
      "person": {
        "legion_id": "a1b2c3d4-e5f6-5a1b-8c3d-4e5f6a1b2c3d",
        "full_name": "jane marie doe jr",
        "first_name": "jane",
        "middle_name": "marie",
        "middle_initial": "m",
        "last_name": "doe",
        "last_initial": "d",
        "suffix": "jr",
        "prefix": "dr",
        "job_title": "senior product manager",
        "company_legion_id": "b2c3d4e5-f6a1-5b2c-9d4e-5f6a1b2c3d4e",
        "company_name": "tech company",
        "company_domain": "techcompany.com",
        "company_linkedin_url": "https://www.linkedin.com/company/techcompany",
        "company_linkedin_id": "12345678",
        "company_industry": "technology, information and internet",
        "company_size": "1001-5000",
        "linkedin_url": "https://www.linkedin.com/in/janedoe",
        "linkedin_id": "556230244",
        "headline": {
          "cleaned": "senior product manager at tech company"
        },
        "summary": {
          "cleaned": "experienced product leader with 10+ years in technology..."
        },
        "skills": [
          {
            "cleaned": "project management"
          },
          {
            "cleaned": "data analysis"
          }
        ],
        "languages": [
          {
            "cleaned": "english",
            "proficiency": "native"
          },
          {
            "cleaned": "spanish",
            "proficiency": "fluent"
          }
        ],
        "experience": [
          {
            "title": {
              "cleaned": "senior product manager"
            },
            "organization": {
              "legion_id": "b2c3d4e5-f6a1-5b2c-9d4e-5f6a1b2c3d4e",
              "name": {
                "cleaned": "tech company inc"
              },
              "website": "techcompany.com",
              "linkedin_url": "https://www.linkedin.com/company/tech-company-inc",
              "linkedin_id": "12345678",
              "industry": "technology, information and internet",
              "size": "1001-5000"
            },
            "start_date": "2020-06-01",
            "end_date": null,
            "current": true,
            "tenure_months": 68,
            "description": {
              "cleaned": "leading product strategy for enterprise platform..."
            }
          },
          {
            "title": {
              "cleaned": "product manager"
            },
            "organization": {
              "legion_id": null,
              "name": {
                "cleaned": "startup corp"
              },
              "website": null,
              "linkedin_url": null,
              "linkedin_id": null,
              "industry": null,
              "size": null
            },
            "start_date": "2017-03-01",
            "end_date": "2020-05-31",
            "current": false,
            "tenure_months": 38,
            "description": {
              "cleaned": "managed b2b saas product from concept to launch..."
            }
          }
        ],
        "education": [
          {
            "organization": {
              "name": {
                "cleaned": "stanford university"
              },
              "website": "stanford.edu",
              "linkedin_url": "https://www.linkedin.com/school/stanford-university"
            },
            "degree": {
              "cleaned": "master of business administration"
            },
            "field_of_study": {
              "cleaned": "business administration"
            },
            "start_date": "2015",
            "end_date": "2017",
            "current": false
          },
          {
            "organization": {
              "name": {
                "cleaned": "university of california berkeley"
              },
              "website": null,
              "linkedin_url": null
            },
            "degree": {
              "cleaned": "bachelor of science in computer science"
            },
            "field_of_study": {
              "cleaned": "computer science"
            },
            "start_date": "2003",
            "end_date": "2007",
            "current": false
          }
        ],
        "socials": [
          {
            "network": "linkedin",
            "url": "https://www.linkedin.com/in/janedoe",
            "id": null,
            "username": "janedoe",
            "current": true
          },
          {
            "network": "github",
            "url": "https://github.com/janedoe",
            "id": "12345678",
            "username": "janedoe",
            "current": true
          }
        ],
        "build_version": "1.5.0_2026-10-15"
      },
      "match_metadata": {
        "matched_on": [
          "social_url"
        ],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}
```

### Person enrichment (base-with-contact)

- Capability: `people/enrich-base-with-contact`
- Description: Matches contain a nested person record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- Instructions: Match a known person using identifiers with the base-with-contact product. Contact entitlement comes from the dedicated credential, never from field projection.
- Cost: 100 credits per successful enrichment call
- Capability file: [Person enrichment (base-with-contact)](https://alexandria.firecrawl.dev/agents/providers/datalegion/people/enrich-base-with-contact)

Accepted options:
- `email` (string): Email address (will be normalized) Example: `<email>`
- `email_hash` (string): SHA-256 (64 chars), SHA-1 (40 chars), or MD5 (32 chars) hash of normalized email address (for privacy) Example: `<email_hash>`
- `phone` (string): Phone number (will be normalized to E.164) Example: `<phone>`
- `linkedin_id` (string): LinkedIn numeric ID Example: `<linkedin_id>`
- `social_url` (string): Social profile URL (LinkedIn, Twitter/X, GitHub, Facebook - will be normalized and detected) Example: `<social_url>`
- `legion_id` (string): Legion ID (exact match) Example: `<legion_id>`
- `full_name` (string): Full name (will be normalized) Example: `<full_name>`
- `first_name` (string): First name (will be normalized) Example: `<first_name>`
- `last_name` (string): Last name (will be normalized) Example: `<last_name>`
- `address` (string): Full address string (will be parsed to extract city, state, postal_code, and country) Example: `<address>`
- `city` (string): City name Example: `<city>`
- `state` (string): State name or code Example: `<state>`
- `country` (string): Country name or code Example: `<country>`
- `postal_code` (string): Postal/ZIP code Example: `<postal_code>`
- `job_title` (string): Job title Example: `<job_title>`
- `company` (string): Company name, website, or social URL Example: `<company>`
- `school` (string): School name, website, or social URL Example: `<school>`
- `birth_date` (string): Birth date for matching or narrowing name-based results (YYYY-MM-DD, YYYY-MM, or YYYY). Can be used as name + birth_date lookup or as a qualifier on other name-based combos. Example: `<birth_date>`
- `min_confidence` (string): Minimum match confidence level to include in results: 'high', 'moderate', or 'low'. Matches below this threshold will be filtered out. Example: `high`
- `titlecase` (boolean): If true, format text fields in title case (names, job titles, company names, locations, skills, headlines). Raw fields, IDs, URLs, codes, and confidence fields are excluded. Example: `false`
- `required_fields` (string): Comma-separated list of fields that must be present, else the match is filtered out. Supports top-level fields ('work_email,phones'), a non-empty list subfield ('emails.type'), or a subfield equal to a value ('emails.type:personal', 'phones.type:mobile', 'socials.network:linkedin'). Unknown field names or out-of-range enum values return HTTP 400. Example: `<required_fields>`
- `include_fields` (string): Comma-separated list of fields to include in response. If omitted, all fields are returned. Example: `<include_fields>`
- `exclude_fields` (string): Comma-separated list of fields to exclude from response. Applied after include_fields filter. Example: `<exclude_fields>`
- `pretty_print` (boolean): If true, pretty-print JSON response with indentation. Example: `false`

Response schema example:
```json
{
  "matches": [
    {
      "person": {
        "legion_id": "a1b2c3d4-e5f6-5a1b-8c3d-4e5f6a1b2c3d",
        "full_name": "jane marie doe jr",
        "first_name": "jane",
        "middle_name": "marie",
        "middle_initial": "m",
        "last_name": "doe",
        "last_initial": "d",
        "suffix": "jr",
        "prefix": "dr",
        "sex": "female",
        "birth_date": "1985-03-15",
        "birth_year": 1985,
        "birth_month": 3,
        "birth_day": 15,
        "age": 41,
        "job_title": "senior product manager",
        "company_legion_id": "b2c3d4e5-f6a1-5b2c-9d4e-5f6a1b2c3d4e",
        "company_name": "tech company",
        "company_domain": "techcompany.com",
        "company_linkedin_url": "https://www.linkedin.com/company/techcompany",
        "company_linkedin_id": "12345678",
        "company_industry": "technology, information and internet",
        "company_size": "1001-5000",
        "work_email": "jane.doe@techcompany.com",
        "mobile_phone": "+15551234567",
        "city": "san francisco",
        "state": "california",
        "state_code": "US-CA",
        "country": "united states",
        "country_code": "US",
        "linkedin_url": "https://www.linkedin.com/in/janedoe",
        "linkedin_id": "556230244",
        "headline": {
          "cleaned": "senior product manager at tech company"
        },
        "summary": {
          "cleaned": "experienced product leader with 10+ years in technology..."
        },
        "skills": [
          {
            "cleaned": "project management"
          },
          {
            "cleaned": "data analysis"
          }
        ],
        "languages": [
          {
            "cleaned": "english",
            "proficiency": "native"
          },
          {
            "cleaned": "spanish",
            "proficiency": "fluent"
          }
        ],
        "phones": [
          {
            "type": "mobile",
            "number": "+15551234567",
            "current": true
          },
          {
            "type": "landline",
            "number": "+15559876543",
            "current": false
          }
        ],
        "emails": [
          {
            "address": "jane.doe@techcompany.com",
            "type": "professional",
            "current": true
          },
          {
            "address": "janedoe@gmail.com",
            "type": "personal",
            "current": null
          }
        ],
        "locations": [
          {
            "street_address": "123 main st",
            "address_line_2": "apt 4b",
            "city": "san francisco",
            "state": "california",
            "state_code": "US-CA",
            "country": "united states",
            "country_code": "US",
            "postal_code": "94102",
            "postal_code_4": "5678",
            "continent": "north america",
            "continent_code": "NA",
            "current": true
          }
        ],
        "experience": [
          {
            "title": {
              "cleaned": "senior product manager"
            },
            "organization": {
              "legion_id": "b2c3d4e5-f6a1-5b2c-9d4e-5f6a1b2c3d4e",
              "name": {
                "cleaned": "tech company inc"
              },
              "website": "techcompany.com",
              "linkedin_url": "https://www.linkedin.com/company/tech-company-inc",
              "linkedin_id": "12345678",
              "industry": "technology, information and internet",
              "size": "1001-5000"
            },
            "start_date": "2020-06-01",
            "end_date": null,
            "current": true,
            "tenure_months": 68,
            "description": {
              "cleaned": "leading product strategy for enterprise platform..."
            }
          },
          {
            "title": {
              "cleaned": "product manager"
            },
            "organization": {
              "legion_id": null,
              "name": {
                "cleaned": "startup corp"
              },
              "website": null,
              "linkedin_url": null,
              "linkedin_id": null,
              "industry": null,
              "size": null
            },
            "start_date": "2017-03-01",
            "end_date": "2020-05-31",
            "current": false,
            "tenure_months": 38,
            "description": {
              "cleaned": "managed b2b saas product from concept to launch..."
            }
          }
        ],
        "education": [
          {
            "organization": {
              "name": {
                "cleaned": "stanford university"
              },
              "website": "stanford.edu",
              "linkedin_url": "https://www.linkedin.com/school/stanford-university"
            },
            "degree": {
              "cleaned": "master of business administration"
            },
            "field_of_study": {
              "cleaned": "business administration"
            },
            "start_date": "2015",
            "end_date": "2017",
            "current": false
          },
          {
            "organization": {
              "name": {
                "cleaned": "university of california berkeley"
              },
              "website": null,
              "linkedin_url": null
            },
            "degree": {
              "cleaned": "bachelor of science in computer science"
            },
            "field_of_study": {
              "cleaned": "computer science"
            },
            "start_date": "2003",
            "end_date": "2007",
            "current": false
          }
        ],
        "socials": [
          {
            "network": "linkedin",
            "url": "https://www.linkedin.com/in/janedoe",
            "id": null,
            "username": "janedoe",
            "current": true
          },
          {
            "network": "github",
            "url": "https://github.com/janedoe",
            "id": "12345678",
            "username": "janedoe",
            "current": true
          }
        ],
        "build_version": "1.5.0_2026-10-15"
      },
      "match_metadata": {
        "matched_on": [
          "social_url"
        ],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}
```

### Person enrichment (premium-no-contact)

- Capability: `people/enrich-premium-no-contact`
- Description: Matches contain a nested person record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- Instructions: Match a known person using identifiers with the premium-no-contact product. Contact entitlement comes from the dedicated credential, never from field projection.
- Cost: 40 credits per successful enrichment call
- Capability file: [Person enrichment (premium-no-contact)](https://alexandria.firecrawl.dev/agents/providers/datalegion/people/enrich-premium-no-contact)

Accepted options:
- `email` (string): Email address (will be normalized) Example: `<email>`
- `email_hash` (string): SHA-256 (64 chars), SHA-1 (40 chars), or MD5 (32 chars) hash of normalized email address (for privacy) Example: `<email_hash>`
- `phone` (string): Phone number (will be normalized to E.164) Example: `<phone>`
- `linkedin_id` (string): LinkedIn numeric ID Example: `<linkedin_id>`
- `social_url` (string): Social profile URL (LinkedIn, Twitter/X, GitHub, Facebook - will be normalized and detected) Example: `<social_url>`
- `legion_id` (string): Legion ID (exact match) Example: `<legion_id>`
- `full_name` (string): Full name (will be normalized) Example: `<full_name>`
- `first_name` (string): First name (will be normalized) Example: `<first_name>`
- `last_name` (string): Last name (will be normalized) Example: `<last_name>`
- `address` (string): Full address string (will be parsed to extract city, state, postal_code, and country) Example: `<address>`
- `city` (string): City name Example: `<city>`
- `state` (string): State name or code Example: `<state>`
- `country` (string): Country name or code Example: `<country>`
- `postal_code` (string): Postal/ZIP code Example: `<postal_code>`
- `job_title` (string): Job title Example: `<job_title>`
- `company` (string): Company name, website, or social URL Example: `<company>`
- `school` (string): School name, website, or social URL Example: `<school>`
- `birth_date` (string): Birth date for matching or narrowing name-based results (YYYY-MM-DD, YYYY-MM, or YYYY). Can be used as name + birth_date lookup or as a qualifier on other name-based combos. Example: `<birth_date>`
- `min_confidence` (string): Minimum match confidence level to include in results: 'high', 'moderate', or 'low'. Matches below this threshold will be filtered out. Example: `high`
- `titlecase` (boolean): If true, format text fields in title case (names, job titles, company names, locations, skills, headlines). Raw fields, IDs, URLs, codes, and confidence fields are excluded. Example: `false`
- `required_fields` (string): Comma-separated list of fields that must be present, else the match is filtered out. Supports top-level fields ('work_email,phones'), a non-empty list subfield ('emails.type'), or a subfield equal to a value ('emails.type:personal', 'phones.type:mobile', 'socials.network:linkedin'). Unknown field names or out-of-range enum values return HTTP 400. Example: `<required_fields>`
- `include_fields` (string): Comma-separated list of fields to include in response. If omitted, all fields are returned. Example: `<include_fields>`
- `exclude_fields` (string): Comma-separated list of fields to exclude from response. Applied after include_fields filter. Example: `<exclude_fields>`
- `pretty_print` (boolean): If true, pretty-print JSON response with indentation. Example: `false`

Response schema example:
```json
{
  "matches": [
    {
      "person": {
        "legion_id": "a1b2c3d4-e5f6-5a1b-8c3d-4e5f6a1b2c3d",
        "full_name": "jane marie doe jr",
        "first_name": "jane",
        "middle_name": "marie",
        "middle_initial": "m",
        "last_name": "doe",
        "last_initial": "d",
        "suffix": "jr",
        "prefix": "dr",
        "job_title": "senior product manager",
        "company_legion_id": "b2c3d4e5-f6a1-5b2c-9d4e-5f6a1b2c3d4e",
        "company_name": "tech company",
        "company_domain": "techcompany.com",
        "company_linkedin_url": "https://www.linkedin.com/company/techcompany",
        "company_linkedin_id": "12345678",
        "company_industry": "technology, information and internet",
        "company_size": "1001-5000",
        "seniority_level": "senior",
        "job_function": "product",
        "expense_category": "research_and_development",
        "is_decision_maker": false,
        "is_platform_worker": false,
        "years_of_experience": 12,
        "avg_tenure_months": 24.5,
        "highest_degree_level": "masters",
        "linkedin_url": "https://www.linkedin.com/in/janedoe",
        "linkedin_id": "556230244",
        "linkedin_followers": 500,
        "linkedin_connections": 450,
        "headline": {
          "cleaned": "senior product manager at tech company",
          "raw": [
            "Senior Product Manager at Tech Company"
          ]
        },
        "summary": {
          "cleaned": "experienced product leader with 10+ years in technology...",
          "raw": [
            "Experienced product leader with 10+ years in technology..."
          ]
        },
        "skills": [
          {
            "raw": [
              "Project Management",
              "PM"
            ],
            "cleaned": "project management"
          },
          {
            "raw": [
              "Data Analysis"
            ],
            "cleaned": "data analysis"
          }
        ],
        "languages": [
          {
            "raw": [
              "English"
            ],
            "cleaned": "english",
            "proficiency": "native"
          },
          {
            "raw": [
              "Spanish",
              "Español"
            ],
            "cleaned": "spanish",
            "proficiency": "fluent"
          }
        ],
        "experience": [
          {
            "title": {
              "cleaned": "senior product manager",
              "raw": [
                "Senior Product Manager",
                "Sr. PM"
              ]
            },
            "organization": {
              "legion_id": "b2c3d4e5-f6a1-5b2c-9d4e-5f6a1b2c3d4e",
              "name": {
                "cleaned": "tech company inc",
                "raw": [
                  "Tech Company Inc",
                  "Tech Company"
                ]
              },
              "website": "techcompany.com",
              "linkedin_url": "https://www.linkedin.com/company/tech-company-inc",
              "linkedin_id": "12345678",
              "industry": "technology, information and internet",
              "size": "1001-5000"
            },
            "start_date": "2020-06-01",
            "end_date": null,
            "current": true,
            "tenure_months": 68,
            "seniority_level": "senior",
            "job_function": "product",
            "expense_category": "research_and_development",
            "is_decision_maker": false,
            "is_platform_worker": false,
            "description": {
              "cleaned": "leading product strategy for enterprise platform...",
              "raw": [
                "Leading product strategy for enterprise platform..."
              ]
            }
          },
          {
            "title": {
              "cleaned": "product manager",
              "raw": [
                "Product Manager"
              ]
            },
            "organization": {
              "legion_id": null,
              "name": {
                "cleaned": "startup corp",
                "raw": [
                  "Startup Corp"
                ]
              },
              "website": null,
              "linkedin_url": null,
              "linkedin_id": null,
              "industry": null,
              "size": null
            },
            "start_date": "2017-03-01",
            "end_date": "2020-05-31",
            "current": false,
            "tenure_months": 38,
            "seniority_level": "manager",
            "job_function": "product",
            "expense_category": "research_and_development",
            "is_decision_maker": false,
            "is_platform_worker": false,
            "description": {
              "cleaned": "managed b2b saas product from concept to launch...",
              "raw": [
                "Managed B2B SaaS product from concept to launch..."
              ]
            }
          }
        ],
        "education": [
          {
            "organization": {
              "name": {
                "cleaned": "stanford university",
                "raw": [
                  "Stanford University"
                ]
              },
              "website": "stanford.edu",
              "linkedin_url": "https://www.linkedin.com/school/stanford-university"
            },
            "degree": {
              "cleaned": "master of business administration",
              "raw": [
                "Master of Business Administration",
                "MBA"
              ]
            },
            "degree_level": "masters",
            "field_of_study": {
              "cleaned": "business administration",
              "raw": [
                "Business Administration"
              ]
            },
            "start_date": "2015",
            "end_date": "2017",
            "current": false
          },
          {
            "organization": {
              "name": {
                "cleaned": "university of california berkeley",
                "raw": [
                  "University of California, Berkeley",
                  "UC Berkeley"
                ]
              },
              "website": null,
              "linkedin_url": null
            },
            "degree": {
              "cleaned": "bachelor of science in computer science",
              "raw": [
                "Bachelor of Science in Computer Science",
                "BS CS"
              ]
            },
            "degree_level": "bachelors",
            "field_of_study": {
              "cleaned": "computer science",
              "raw": [
                "Computer Science"
              ]
            },
            "start_date": "2003",
            "end_date": "2007",
            "current": false
          }
        ],
        "certifications": [
          {
            "name": {
              "cleaned": "project management professional",
              "raw": [
                "Project Management Professional",
                "PMP"
              ]
            },
            "institution": {
              "cleaned": "project management institute",
              "raw": [
                "Project Management Institute",
                "PMI"
              ]
            },
            "credential_id": "1234567",
            "issue_date": "2018-06",
            "expiration_date": "2024-06"
          },
          {
            "name": {
              "cleaned": "aws certified solutions architect",
              "raw": [
                "AWS Certified Solutions Architect — Associate"
              ]
            },
            "institution": {
              "cleaned": "amazon web services",
              "raw": [
                "Amazon Web Services"
              ]
            },
            "credential_id": null,
            "issue_date": "2021-03",
            "expiration_date": "2024-03"
          }
        ],
        "socials": [
          {
            "network": "linkedin",
            "url": "https://www.linkedin.com/in/janedoe",
            "id": null,
            "username": "janedoe",
            "current": true,
            "confidence": "high",
            "num_sources": 2,
            "last_seen": "2026-01-20"
          },
          {
            "network": "github",
            "url": "https://github.com/janedoe",
            "id": "12345678",
            "username": "janedoe",
            "current": true,
            "confidence": "moderate",
            "num_sources": 1,
            "last_seen": "2026-01-20"
          }
        ],
        "num_sources": 3,
        "current_jobs_last_updated": "2026-01-15",
        "current_jobs_last_confirmed": "2026-01-20",
        "last_seen": "2026-01-20",
        "build_version": "1.5.0_2026-10-15"
      },
      "match_metadata": {
        "matched_on": [
          "social_url"
        ],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}
```

### Person enrichment (premium-with-contact)

- Capability: `people/enrich-premium-with-contact`
- Description: Matches contain a nested person record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- Instructions: Match a known person using identifiers with the premium-with-contact product. Contact entitlement comes from the dedicated credential, never from field projection.
- Cost: 160 credits per successful enrichment call
- Capability file: [Person enrichment (premium-with-contact)](https://alexandria.firecrawl.dev/agents/providers/datalegion/people/enrich-premium-with-contact)

Accepted options:
- `email` (string): Email address (will be normalized) Example: `<email>`
- `email_hash` (string): SHA-256 (64 chars), SHA-1 (40 chars), or MD5 (32 chars) hash of normalized email address (for privacy) Example: `<email_hash>`
- `phone` (string): Phone number (will be normalized to E.164) Example: `<phone>`
- `linkedin_id` (string): LinkedIn numeric ID Example: `<linkedin_id>`
- `social_url` (string): Social profile URL (LinkedIn, Twitter/X, GitHub, Facebook - will be normalized and detected) Example: `<social_url>`
- `legion_id` (string): Legion ID (exact match) Example: `<legion_id>`
- `full_name` (string): Full name (will be normalized) Example: `<full_name>`
- `first_name` (string): First name (will be normalized) Example: `<first_name>`
- `last_name` (string): Last name (will be normalized) Example: `<last_name>`
- `address` (string): Full address string (will be parsed to extract city, state, postal_code, and country) Example: `<address>`
- `city` (string): City name Example: `<city>`
- `state` (string): State name or code Example: `<state>`
- `country` (string): Country name or code Example: `<country>`
- `postal_code` (string): Postal/ZIP code Example: `<postal_code>`
- `job_title` (string): Job title Example: `<job_title>`
- `company` (string): Company name, website, or social URL Example: `<company>`
- `school` (string): School name, website, or social URL Example: `<school>`
- `birth_date` (string): Birth date for matching or narrowing name-based results (YYYY-MM-DD, YYYY-MM, or YYYY). Can be used as name + birth_date lookup or as a qualifier on other name-based combos. Example: `<birth_date>`
- `min_confidence` (string): Minimum match confidence level to include in results: 'high', 'moderate', or 'low'. Matches below this threshold will be filtered out. Example: `high`
- `titlecase` (boolean): If true, format text fields in title case (names, job titles, company names, locations, skills, headlines). Raw fields, IDs, URLs, codes, and confidence fields are excluded. Example: `false`
- `required_fields` (string): Comma-separated list of fields that must be present, else the match is filtered out. Supports top-level fields ('work_email,phones'), a non-empty list subfield ('emails.type'), or a subfield equal to a value ('emails.type:personal', 'phones.type:mobile', 'socials.network:linkedin'). Unknown field names or out-of-range enum values return HTTP 400. Example: `<required_fields>`
- `include_fields` (string): Comma-separated list of fields to include in response. If omitted, all fields are returned. Example: `<include_fields>`
- `exclude_fields` (string): Comma-separated list of fields to exclude from response. Applied after include_fields filter. Example: `<exclude_fields>`
- `pretty_print` (boolean): If true, pretty-print JSON response with indentation. Example: `false`

Response schema example:
```json
{
  "matches": [
    {
      "person": {
        "legion_id": "a1b2c3d4-e5f6-5a1b-8c3d-4e5f6a1b2c3d",
        "full_name": "jane marie doe jr",
        "first_name": "jane",
        "middle_name": "marie",
        "middle_initial": "m",
        "last_name": "doe",
        "last_initial": "d",
        "suffix": "jr",
        "prefix": "dr",
        "sex": "female",
        "birth_date": "1985-03-15",
        "birth_year": 1985,
        "birth_month": 3,
        "birth_day": 15,
        "age": 41,
        "job_title": "senior product manager",
        "company_legion_id": "b2c3d4e5-f6a1-5b2c-9d4e-5f6a1b2c3d4e",
        "company_name": "tech company",
        "company_domain": "techcompany.com",
        "company_linkedin_url": "https://www.linkedin.com/company/techcompany",
        "company_linkedin_id": "12345678",
        "company_industry": "technology, information and internet",
        "company_size": "1001-5000",
        "seniority_level": "senior",
        "job_function": "product",
        "expense_category": "research_and_development",
        "is_decision_maker": false,
        "is_platform_worker": false,
        "years_of_experience": 12,
        "avg_tenure_months": 24.5,
        "highest_degree_level": "masters",
        "work_email": "jane.doe@techcompany.com",
        "mobile_phone": "+15551234567",
        "city": "san francisco",
        "state": "california",
        "state_code": "US-CA",
        "country": "united states",
        "country_code": "US",
        "linkedin_url": "https://www.linkedin.com/in/janedoe",
        "linkedin_id": "556230244",
        "linkedin_followers": 500,
        "linkedin_connections": 450,
        "headline": {
          "cleaned": "senior product manager at tech company",
          "raw": [
            "Senior Product Manager at Tech Company"
          ]
        },
        "summary": {
          "cleaned": "experienced product leader with 10+ years in technology...",
          "raw": [
            "Experienced product leader with 10+ years in technology..."
          ]
        },
        "skills": [
          {
            "raw": [
              "Project Management",
              "PM"
            ],
            "cleaned": "project management"
          },
          {
            "raw": [
              "Data Analysis"
            ],
            "cleaned": "data analysis"
          }
        ],
        "languages": [
          {
            "raw": [
              "English"
            ],
            "cleaned": "english",
            "proficiency": "native"
          },
          {
            "raw": [
              "Spanish",
              "Español"
            ],
            "cleaned": "spanish",
            "proficiency": "fluent"
          }
        ],
        "phones": [
          {
            "type": "mobile",
            "number": "+15551234567",
            "current": true,
            "confidence": "high",
            "num_sources": 3,
            "last_seen": "2026-01-15"
          },
          {
            "type": "landline",
            "number": "+15559876543",
            "current": false,
            "confidence": "low",
            "num_sources": 1,
            "last_seen": "2024-06-01"
          }
        ],
        "emails": [
          {
            "address": "jane.doe@techcompany.com",
            "type": "professional",
            "current": true,
            "validated": true,
            "validation_status": "valid",
            "confidence": "high",
            "num_sources": 2,
            "last_seen": "2026-01-20",
            "hash_sha256": "30635629dd8765da9df5e2eaf96313b4ec1ecaa918fc75586a34dada419cc150",
            "hash_sha1": "8536f7aa61cbb79c1ed3771e4cce7eb9fcf009d6",
            "hash_md5": "44087cd018be7077209cf1eccd76d0f8"
          },
          {
            "address": "janedoe@gmail.com",
            "type": "personal",
            "current": null,
            "validated": false,
            "validation_status": null,
            "confidence": "high",
            "num_sources": 2,
            "last_seen": "2024-12-01",
            "hash_sha256": "d6117306485ed0e50afab3ac871e98f81699151f30281527d63ff5f233656c69",
            "hash_sha1": "3e12c6d13e5c00d46fee94de65239ce9c5e7bc25",
            "hash_md5": "a9601f3839e5d5da764c1861a5e1daf6"
          }
        ],
        "locations": [
          {
            "street_address": "123 main st",
            "address_line_2": "apt 4b",
            "city": "san francisco",
            "state": "california",
            "state_code": "US-CA",
            "country": "united states",
            "country_code": "US",
            "postal_code": "94102",
            "postal_code_4": "5678",
            "continent": "north america",
            "continent_code": "NA",
            "geo": "37.7749,-122.4194",
            "raw": [
              "123 Main St, Apt 4B, San Francisco, CA 94102"
            ],
            "current": true,
            "confidence": "high",
            "num_sources": 2,
            "last_seen": "2026-01-10"
          }
        ],
        "experience": [
          {
            "title": {
              "cleaned": "senior product manager",
              "raw": [
                "Senior Product Manager",
                "Sr. PM"
              ]
            },
            "organization": {
              "legion_id": "b2c3d4e5-f6a1-5b2c-9d4e-5f6a1b2c3d4e",
              "name": {
                "cleaned": "tech company inc",
                "raw": [
                  "Tech Company Inc",
                  "Tech Company"
                ]
              },
              "website": "techcompany.com",
              "linkedin_url": "https://www.linkedin.com/company/tech-company-inc",
              "linkedin_id": "12345678",
              "industry": "technology, information and internet",
              "size": "1001-5000"
            },
            "start_date": "2020-06-01",
            "end_date": null,
            "current": true,
            "tenure_months": 68,
            "seniority_level": "senior",
            "job_function": "product",
            "expense_category": "research_and_development",
            "is_decision_maker": false,
            "is_platform_worker": false,
            "description": {
              "cleaned": "leading product strategy for enterprise platform...",
              "raw": [
                "Leading product strategy for enterprise platform..."
              ]
            }
          },
          {
            "title": {
              "cleaned": "product manager",
              "raw": [
                "Product Manager"
              ]
            },
            "organization": {
              "legion_id": null,
              "name": {
                "cleaned": "startup corp",
                "raw": [
                  "Startup Corp"
                ]
              },
              "website": null,
              "linkedin_url": null,
              "linkedin_id": null,
              "industry": null,
              "size": null
            },
            "start_date": "2017-03-01",
            "end_date": "2020-05-31",
            "current": false,
            "tenure_months": 38,
            "seniority_level": "manager",
            "job_function": "product",
            "expense_category": "research_and_development",
            "is_decision_maker": false,
            "is_platform_worker": false,
            "description": {
              "cleaned": "managed b2b saas product from concept to launch...",
              "raw": [
                "Managed B2B SaaS product from concept to launch..."
              ]
            }
          }
        ],
        "education": [
          {
            "organization": {
              "name": {
                "cleaned": "stanford university",
                "raw": [
                  "Stanford University"
                ]
              },
              "website": "stanford.edu",
              "linkedin_url": "https://www.linkedin.com/school/stanford-university"
            },
            "degree": {
              "cleaned": "master of business administration",
              "raw": [
                "Master of Business Administration",
                "MBA"
              ]
            },
            "degree_level": "masters",
            "field_of_study": {
              "cleaned": "business administration",
              "raw": [
                "Business Administration"
              ]
            },
            "start_date": "2015",
            "end_date": "2017",
            "current": false
          },
          {
            "organization": {
              "name": {
                "cleaned": "university of california berkeley",
                "raw": [
                  "University of California, Berkeley",
                  "UC Berkeley"
                ]
              },
              "website": null,
              "linkedin_url": null
            },
            "degree": {
              "cleaned": "bachelor of science in computer science",
              "raw": [
                "Bachelor of Science in Computer Science",
                "BS CS"
              ]
            },
            "degree_level": "bachelors",
            "field_of_study": {
              "cleaned": "computer science",
              "raw": [
                "Computer Science"
              ]
            },
            "start_date": "2003",
            "end_date": "2007",
            "current": false
          }
        ],
        "certifications": [
          {
            "name": {
              "cleaned": "project management professional",
              "raw": [
                "Project Management Professional",
                "PMP"
              ]
            },
            "institution": {
              "cleaned": "project management institute",
              "raw": [
                "Project Management Institute",
                "PMI"
              ]
            },
            "credential_id": "1234567",
            "issue_date": "2018-06",
            "expiration_date": "2024-06"
          },
          {
            "name": {
              "cleaned": "aws certified solutions architect",
              "raw": [
                "AWS Certified Solutions Architect — Associate"
              ]
            },
            "institution": {
              "cleaned": "amazon web services",
              "raw": [
                "Amazon Web Services"
              ]
            },
            "credential_id": null,
            "issue_date": "2021-03",
            "expiration_date": "2024-03"
          }
        ],
        "socials": [
          {
            "network": "linkedin",
            "url": "https://www.linkedin.com/in/janedoe",
            "id": null,
            "username": "janedoe",
            "current": true,
            "confidence": "high",
            "num_sources": 2,
            "last_seen": "2026-01-20"
          },
          {
            "network": "github",
            "url": "https://github.com/janedoe",
            "id": "12345678",
            "username": "janedoe",
            "current": true,
            "confidence": "moderate",
            "num_sources": 1,
            "last_seen": "2026-01-20"
          }
        ],
        "num_sources": 3,
        "current_jobs_last_updated": "2026-01-15",
        "current_jobs_last_confirmed": "2026-01-20",
        "current_location_last_updated": "2025-09-01",
        "current_location_last_confirmed": "2026-01-10",
        "last_seen": "2026-01-20",
        "build_version": "1.5.0_2026-10-15"
      },
      "match_metadata": {
        "matched_on": [
          "social_url"
        ],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}
```

### Company enrichment (base)

- Capability: `companies/enrich-base`
- Description: Matches contain a nested company record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- Instructions: Match a known company using identifiers with the base product. Name matching is global and cannot be narrowed by country, so for non-US or ambiguous names also send the website domain as domain, or the LinkedIn company page URL as social_url.
- Cost: 20 credits per successful enrichment call
- Capability file: [Company enrichment (base)](https://alexandria.firecrawl.dev/agents/providers/datalegion/companies/enrich-base)

Accepted options:
- `legion_id` (string): Company Legion ID (exact match) Example: `<legion_id>`
- `domain` (string): Company website domain (e.g., google.com) Example: `<domain>`
- `name` (string): Company name (fuzzy matching) Example: `<name>`
- `linkedin_id` (string): LinkedIn company numeric ID Example: `<linkedin_id>`
- `social_url` (string): Social profile URL (LinkedIn, Facebook, Crunchbase, X/Twitter, GitHub - will be normalized and detected) Example: `<social_url>`
- `ticker_symbol` (string): Stock ticker symbol (e.g., GOOGL) Example: `<ticker_symbol>`
- `industry` (string): Industry filter (used with name matching for better accuracy) Example: `<industry>`
- `min_confidence` (string): Minimum match confidence: 'high', 'moderate', or 'low' Example: `high`
- `titlecase` (boolean): If true, format text fields in title case (names, company names, locations). Raw fields, IDs, URLs, codes, and confidence fields are excluded. Example: `false`
- `required_fields` (string): Comma-separated list of fields that must be present, else the match is filtered out. Supports top-level fields ('domain,socials'), a non-empty list subfield ('socials.network'), or a subfield equal to a value ('type:public', 'socials.network:linkedin'). Unknown field names or out-of-range enum values return HTTP 400. Example: `<required_fields>`
- `include_fields` (string): Comma-separated list of fields to include in response. If omitted, all fields are returned. Example: `<include_fields>`
- `exclude_fields` (string): Comma-separated list of fields to exclude from response. Applied after include_fields filter. Example: `<exclude_fields>`
- `pretty_print` (boolean): If true, pretty-print JSON response with indentation. Example: `false`

Response schema example:
```json
{
  "matches": [
    {
      "company": {
        "legion_id": "c1d2e3f4-a5b6-5c1d-8e3f-4a5b6c1d2e3f",
        "name": {
          "cleaned": "acme corporation"
        },
        "headline": {
          "cleaned": "enterprise software solutions for modern businesses"
        },
        "description": {
          "cleaned": "acme corporation is a leading provider of enterprise software..."
        },
        "domain": "acmecorp.com",
        "tickers": [
          {
            "symbol": "ACME",
            "exchange": "NYSE"
          }
        ],
        "linkedin_url": "https://www.linkedin.com/company/acme-corporation",
        "linkedin_id": "12345678",
        "industry": "software development",
        "type": "public",
        "size": "1001-5000",
        "founded": 2005,
        "socials": [
          {
            "network": "linkedin",
            "url": "https://www.linkedin.com/company/acme-corporation",
            "username": "acme-corporation",
            "id": "12345678"
          },
          {
            "network": "crunchbase",
            "url": "https://www.crunchbase.com/organization/acme-corporation",
            "username": "acme-corporation",
            "id": null
          },
          {
            "network": "x",
            "url": "https://www.x.com/acmecorp",
            "username": "acmecorp",
            "id": "98765432"
          }
        ],
        "domains": [
          {
            "domain": "acmecorp.com"
          },
          {
            "domain": "acme.io"
          },
          {
            "domain": "acme.co"
          }
        ],
        "locations": [
          {
            "street_address": "100 market st",
            "address_line_2": "suite 300",
            "city": "san francisco",
            "state": "california",
            "state_code": "US-CA",
            "country": "united states",
            "country_code": "US",
            "continent": "north america",
            "continent_code": "NA",
            "postal_code": "94105",
            "current": true,
            "primary": true
          },
          {
            "street_address": "500 w 2nd st",
            "address_line_2": null,
            "city": "austin",
            "state": "texas",
            "state_code": "US-TX",
            "country": "united states",
            "country_code": "US",
            "continent": "north america",
            "continent_code": "NA",
            "postal_code": "78701",
            "current": false,
            "primary": false
          }
        ],
        "build_version": "1.5.0_2026-10-15"
      },
      "match_metadata": {
        "matched_on": [
          "domain"
        ],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}
```

### Company enrichment (premium)

- Capability: `companies/enrich-premium`
- Description: Matches contain a nested company record. Optional fields depend on entitlement and field selection. The outer total reports matches found.
- Instructions: Match a known company using identifiers with the premium product. Name matching is global and cannot be narrowed by country, so for non-US or ambiguous names also send the website domain as domain, or the LinkedIn company page URL as social_url.
- Cost: 40 credits per successful enrichment call
- Capability file: [Company enrichment (premium)](https://alexandria.firecrawl.dev/agents/providers/datalegion/companies/enrich-premium)

Accepted options:
- `legion_id` (string): Company Legion ID (exact match) Example: `<legion_id>`
- `domain` (string): Company website domain (e.g., google.com) Example: `<domain>`
- `name` (string): Company name (fuzzy matching) Example: `<name>`
- `linkedin_id` (string): LinkedIn company numeric ID Example: `<linkedin_id>`
- `social_url` (string): Social profile URL (LinkedIn, Facebook, Crunchbase, X/Twitter, GitHub - will be normalized and detected) Example: `<social_url>`
- `ticker_symbol` (string): Stock ticker symbol (e.g., GOOGL) Example: `<ticker_symbol>`
- `industry` (string): Industry filter (used with name matching for better accuracy) Example: `<industry>`
- `min_confidence` (string): Minimum match confidence: 'high', 'moderate', or 'low' Example: `high`
- `titlecase` (boolean): If true, format text fields in title case (names, company names, locations). Raw fields, IDs, URLs, codes, and confidence fields are excluded. Example: `false`
- `required_fields` (string): Comma-separated list of fields that must be present, else the match is filtered out. Supports top-level fields ('domain,socials'), a non-empty list subfield ('socials.network'), or a subfield equal to a value ('type:public', 'socials.network:linkedin'). Unknown field names or out-of-range enum values return HTTP 400. Example: `<required_fields>`
- `include_fields` (string): Comma-separated list of fields to include in response. If omitted, all fields are returned. Example: `<include_fields>`
- `exclude_fields` (string): Comma-separated list of fields to exclude from response. Applied after include_fields filter. Example: `<exclude_fields>`
- `pretty_print` (boolean): If true, pretty-print JSON response with indentation. Example: `false`

Response schema example:
```json
{
  "matches": [
    {
      "company": {
        "legion_id": "c1d2e3f4-a5b6-5c1d-8e3f-4a5b6c1d2e3f",
        "name": {
          "cleaned": "acme corporation",
          "display": "Acme Corporation",
          "raw": [
            "Acme Corporation",
            "ACME Corp",
            "Acme Corp."
          ]
        },
        "headline": {
          "cleaned": "enterprise software solutions for modern businesses",
          "raw": [
            "Enterprise Software Solutions for Modern Businesses",
            "Enterprise software solutions"
          ]
        },
        "description": {
          "cleaned": "acme corporation is a leading provider of enterprise software...",
          "raw": [
            "Acme Corporation is a leading provider of enterprise software...",
            "Leading enterprise software company..."
          ]
        },
        "domain": "acmecorp.com",
        "tickers": [
          {
            "symbol": "ACME",
            "exchange": "NYSE"
          }
        ],
        "linkedin_url": "https://www.linkedin.com/company/acme-corporation",
        "linkedin_id": "12345678",
        "linkedin_followers": 45000,
        "linkedin_employee_count": 3200,
        "legion_employee_count": 2893,
        "industry": "software development",
        "type": "public",
        "size": "1001-5000",
        "founded": 2005,
        "socials": [
          {
            "network": "linkedin",
            "url": "https://www.linkedin.com/company/acme-corporation",
            "username": "acme-corporation",
            "id": "12345678"
          },
          {
            "network": "crunchbase",
            "url": "https://www.crunchbase.com/organization/acme-corporation",
            "username": "acme-corporation",
            "id": null
          },
          {
            "network": "x",
            "url": "https://www.x.com/acmecorp",
            "username": "acmecorp",
            "id": "98765432"
          }
        ],
        "domains": [
          {
            "domain": "acmecorp.com"
          },
          {
            "domain": "acme.io"
          },
          {
            "domain": "acme.co"
          }
        ],
        "locations": [
          {
            "street_address": "100 market st",
            "address_line_2": "suite 300",
            "city": "san francisco",
            "state": "california",
            "state_code": "US-CA",
            "country": "united states",
            "country_code": "US",
            "continent": "north america",
            "continent_code": "NA",
            "postal_code": "94105",
            "geo": "37.79,-122.40",
            "raw": [
              "100 Market St, Suite 300, San Francisco, CA 94105"
            ],
            "current": true,
            "primary": true,
            "num_sources": 2,
            "last_seen": "2026-08-01"
          },
          {
            "street_address": "500 w 2nd st",
            "address_line_2": null,
            "city": "austin",
            "state": "texas",
            "state_code": "US-TX",
            "country": "united states",
            "country_code": "US",
            "continent": "north america",
            "continent_code": "NA",
            "postal_code": "78701",
            "geo": "30.27,-97.75",
            "raw": [
              "500 W 2nd St, Austin, TX 78701"
            ],
            "current": false,
            "primary": false,
            "num_sources": 1,
            "last_seen": "2025-05-14"
          }
        ],
        "legion_employee_count_by_month": [
          {
            "month": "2024-08",
            "count": 2582,
            "net_change": 22,
            "growth_rate": 0.0086,
            "hires": 31,
            "departures": 9
          },
          {
            "month": "2024-09",
            "count": 2599,
            "net_change": 17,
            "growth_rate": 0.0066,
            "hires": 28,
            "departures": 11
          },
          {
            "month": "2024-10",
            "count": 2624,
            "net_change": 25,
            "growth_rate": 0.0096,
            "hires": 33,
            "departures": 8
          },
          {
            "month": "2024-11",
            "count": 2643,
            "net_change": 19,
            "growth_rate": 0.0072,
            "hires": 29,
            "departures": 10
          },
          {
            "month": "2024-12",
            "count": 2653,
            "net_change": 10,
            "growth_rate": 0.0038,
            "hires": 22,
            "departures": 12
          },
          {
            "month": "2025-01",
            "count": 2685,
            "net_change": 32,
            "growth_rate": 0.0121,
            "hires": 41,
            "departures": 9
          },
          {
            "month": "2025-02",
            "count": 2714,
            "net_change": 29,
            "growth_rate": 0.0108,
            "hires": 36,
            "departures": 7
          },
          {
            "month": "2025-03",
            "count": 2743,
            "net_change": 29,
            "growth_rate": 0.0107,
            "hires": 39,
            "departures": 10
          },
          {
            "month": "2025-04",
            "count": 2769,
            "net_change": 26,
            "growth_rate": 0.0095,
            "hires": 34,
            "departures": 8
          },
          {
            "month": "2025-05",
            "count": 2795,
            "net_change": 26,
            "growth_rate": 0.0094,
            "hires": 37,
            "departures": 11
          },
          {
            "month": "2025-06",
            "count": 2826,
            "net_change": 31,
            "growth_rate": 0.0111,
            "hires": 40,
            "departures": 9
          },
          {
            "month": "2025-07",
            "count": 2858,
            "net_change": 32,
            "growth_rate": 0.0113,
            "hires": 38,
            "departures": 6
          },
          {
            "month": "2025-08",
            "count": 2893,
            "net_change": 35,
            "growth_rate": 0.0122,
            "hires": 42,
            "departures": 7
          }
        ],
        "legion_new_hire_count": {
          "1m": 42,
          "3m": 120,
          "6m": 230,
          "12m": 419
        },
        "legion_employee_growth_rate": {
          "1m": 0.0122,
          "3m": 0.0351,
          "6m": 0.066,
          "12m": 0.1204
        },
        "legion_attrition_count": {
          "1m": 7,
          "3m": 22,
          "6m": 51,
          "12m": 108
        },
        "legion_turnover_rate": {
          "1m": 0.0024,
          "3m": 0.0079,
          "6m": 0.0188,
          "12m": 0.0418
        },
        "legion_average_tenure": 38.4,
        "legion_tenure_distribution": {
          "<1yr": 345,
          "1-2yr": 528,
          "2-5yr": 996,
          "5-10yr": 661,
          "10+yr": 363
        },
        "legion_seniority_distribution": {
          "senior": 833,
          "manager": 457,
          "director": 183,
          "vp": 66,
          "c_level": 12,
          "junior": 1342
        },
        "legion_job_function_distribution": {
          "engineering": 793,
          "sales": 488,
          "marketing": 325,
          "operations": 396,
          "information_technology": 244,
          "product": 193,
          "customer_success": 132,
          "finance": 122,
          "hr": 147,
          "legal": 53
        },
        "legion_expense_category_distribution": {
          "research_and_development": 1072,
          "sales_and_marketing": 854,
          "general_and_administrative": 620,
          "cost_of_services": 347
        },
        "legion_education_distribution": {
          "doctorate": 97,
          "masters": 691,
          "bachelors": 1605,
          "associates": 315,
          "high_school": 185
        },
        "legion_seniority_growth_rate": {
          "senior": {
            "1m": 0.02,
            "3m": 0.05,
            "6m": 0.08,
            "12m": 0.15
          },
          "manager": {
            "1m": 0.01,
            "3m": 0.03,
            "6m": 0.06,
            "12m": 0.12
          },
          "director": {
            "1m": null,
            "3m": 0.02,
            "6m": 0.04,
            "12m": 0.09
          }
        },
        "legion_job_function_growth_rate": {
          "engineering": {
            "1m": 0.04,
            "3m": 0.1,
            "6m": 0.18,
            "12m": 0.28
          },
          "sales": {
            "1m": 0.01,
            "3m": 0.03,
            "6m": 0.05,
            "12m": 0.08
          },
          "marketing": {
            "1m": 0.02,
            "3m": 0.05,
            "6m": 0.09,
            "12m": 0.15
          }
        },
        "legion_expense_category_growth_rate": {
          "research_and_development": {
            "1m": 0.03,
            "3m": 0.08,
            "6m": 0.14,
            "12m": 0.22
          },
          "sales_and_marketing": {
            "1m": 0.01,
            "3m": 0.04,
            "6m": 0.07,
            "12m": 0.11
          },
          "general_and_administrative": {
            "1m": 0.01,
            "3m": 0.02,
            "6m": 0.03,
            "12m": 0.05
          }
        },
        "num_sources": 3,
        "last_seen": "2026-01-15",
        "build_version": "1.5.0_2026-10-15"
      },
      "match_metadata": {
        "matched_on": [
          "domain"
        ],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}
```