Firecrawl Alexandria

Data Legion is a provider on Firecrawl Alexandria, Firecrawl’s catalog of data providers for agents. If your agent already uses Firecrawl, it can call Data Legion person and company enrichment with its Firecrawl API key. You don’t need a Data Legion account or API key, and usage is billed in Firecrawl credits.

Prerequisites

A Firecrawl account and API key
An organization admin who has accepted Data Legion’s data terms in the Firecrawl dashboard (see Accept the data terms)
The Firecrawl SDK: pip install firecrawl-py or npm install @mendable/firecrawl-js

Capabilities

Data Legion is listed under People and Company. The provider name is datalegion.

Capability	Data Legion product	Returns
`people/enrich-base-no-contact`	Person Base	Identity, current role and company, work history, education, skills, social profiles
`people/enrich-base-with-contact`	Person Base with contact data	Person Base plus emails, phones, location, age, and sex
`people/enrich-premium-no-contact`	Person Premium	Person Base plus seniority, job function, decision-maker flag, tenure, and data freshness
`people/enrich-premium-with-contact`	Person Premium with contact data	Person Premium plus emails, phones, location, age, and sex
`companies/enrich-base`	Company Base	Firmographics: name, domains, industry, size, type, founding year, description
`companies/enrich-premium`	Company Premium	Company Base plus headcount, growth, turnover, and workforce breakdowns

A call is charged only when it returns a match. The credit cost of each capability is shown on the Data Legion listing in your Firecrawl dashboard.

Inputs

The options object takes the same fields as the Data Legion enrich endpoints. Person capabilities take email, email_hash, phone, social_url, or a name (full_name, or first_name and last_name) paired with one more detail such as company, school, job_title, or city. See the Person Enrichment API reference for every field. Company capabilities take domain, name, linkedin_id, or ticker_symbol. See the Company Enrichment API reference for every field.

Calling a Capability

An Alexandria call is a Firecrawl scrape with an alexandria block instead of a URL.

import os

from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key=os.environ["FIRECRAWL_API_KEY"])

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

entry = result.alexandria[0]

import Firecrawl from "@mendable/firecrawl-js";

const firecrawl = new Firecrawl({ apiKey: process.env.FIRECRAWL_API_KEY });

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

const entry = result.alexandria[0];

For a company, change the capability and pass a company input, for example "capability": "companies/enrich-base" with "options": {"domain": "hubspot.com"}.

Response

Each entry in alexandria has a data object with the standard Data Legion enrich response, plus the call’s credit cost (creditsCost in JavaScript, credits_cost in Python):

{
  "matches": [
    {
      "person": {
        "full_name": "jane doe",
        "job_title": "senior product manager",
        "seniority_level": "senior",
        "company_name": "tech company",
        "linkedin_url": "https://www.linkedin.com/in/janedoe"
      },
      "match_metadata": {
        "matched_on": ["social_url"],
        "match_type": "exact",
        "match_confidence": "high"
      }
    }
  ],
  "total": 1
}

Company capabilities return company in place of person. Field definitions are in the Person Schema and Company Schema. A failed call returns an error object with a code and message instead of data. Check for it before reading the record.

Accept the Data Terms

Alexandria requires each Firecrawl organization to accept a provider’s data terms before calling it. Until an admin accepts them, requests fail with HTTP 403 and the code THIRD_PARTY_DATA_TERMS_REQUIRED, and the error’s requiresAction.url points to where an admin accepts them. Both SDKs raise this as an exception (ProviderTermsRequiredError in Python), so it never reaches the per-call error object.

Firecrawl’s guidance is that agents need explicit user authorization before accepting terms. Have a person accept them once in the Firecrawl dashboard rather than letting an agent do it.

Discovery

Agents don’t need the capability names hardcoded. Firecrawl’s find_tools (findTools in JavaScript), or a search request with sources: ["alexandria"], returns matching providers with their capability paths, inputs, response contracts, and pricing. Discovery is free.

Alexandria or the Data Legion API

Alexandria covers enrichment, one record per call, on your Firecrawl key and bill. Search, natural-language discovery, bulk delivery, and higher rate limits are on the Data Legion API, which uses a Data Legion API key.

Person Enrichment API
Company Enrichment API
MCP Server for connecting AI assistants directly
Firecrawl documentation

Getting Started

Person Data

Company Data

Data Quality

Data Standardization

SDKs

Integrations

Prerequisites

Capabilities

Inputs

Calling a Capability

Response

Accept the Data Terms

Discovery

Alexandria or the Data Legion API

​Prerequisites

​Capabilities

​Inputs

​Calling a Capability

​Response

​Accept the Data Terms

​Discovery

​Alexandria or the Data Legion API

​Related

Prerequisites

Capabilities

Inputs

Calling a Capability

Response

Accept the Data Terms

Discovery

Alexandria or the Data Legion API

Related