Batch Company Enrichment API

Endpoint essentials

Detail	Value
API key and headers	Send `Authorization: Bearer YOUR_API_KEY` and `x-api-version: 2025-11-01` with every request.
Access	Enterprise plans. Check your account with Permissions.
Free account	No
Credit cost	Same as Company Enrichment, 2 to 4 credits per company
Batch size	10,000 companies per job
Rate limit	Up to 5 jobs can run at the same time.

Batch Company Enrichment takes up to 10,000 companies per job, identified by domain, name, profile URL or Crustdata ID, with one identifier type per job. The job runs in the background. You get a batch_id straight away, then poll GET /batch/{batch_id} or pass a webhook_url to be told when it finishes. A completed job returns a download_url for one results file and download_urls for the same data split into parts. Files are gzipped JSONL with one company per line, and the links stay valid for 5 days. Batch enrichment takes a list of identifiers you already have and returns the enriched record for each as a single results file, instead of one Company Enrich call per company.

POST https://api.crustdata.com/batch/company/enrich

Identifiers: exactly one type per job

Each job takes exactly one identifier type with up to 10,000 identifiers — providing none, or more than one type, returns 400; over-cap submissions are rejected. String-list identifiers also accept a single comma-separated string.

Identifier type	Example values
`domains`	`["stripe.com", "openai.com"]`
`names`	`["Stripe", "OpenAI"]`
`professional_network_profile_urls`	`["https://www.linkedin.com/company/stripe"]`
`crustdata_company_ids`	`[631394, 631466]`

Your first batch enrichment: companies by domain

curl --request POST \
  --url https://api.crustdata.com/batch/company/enrich \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --header 'x-api-version: 2025-11-01' \
  --data '{
    "domains": ["stripe.com", "openai.com"],
    "fields": ["basic_info.name", "basic_info.primary_domain", "headcount.total"]
  }'

{
    "batch_id": "53ab686b-c054-496b-8baf-baff5ecc85cf",
    "status": "pending",
    "entity": "company",
    "action": "enrich",
    "identifier_count": 2,
    "entities_requested": 2,
    "status_url": "/batch/53ab686b-c054-496b-8baf-baff5ecc85cf"
}

When the job completes, each line in the downloaded file is one company wrapped in the enrichment envelope:

One record from the results file

{
    "original_identifier": "stripe.com",
    "internal_id": 631394,
    "data": {
        "crustdata_company_id": 631394,
        "basic_info": {
            "name": "Stripe",
            "primary_domain": "stripe.com",
            "company_type": "Privately Held",
            "year_founded": 2010
        },
        "headcount": {
            "total": 15554
        }
    }
}

Record trimmed for clarity.

Enrich by Crustdata ID

If you already hold crustdata_company_id values — for example from a previous search — they are the most precise identifier type. In the results file, original_identifier echoes the ID you submitted as a string:

curl --request POST \
  --url https://api.crustdata.com/batch/company/enrich \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --header 'x-api-version: 2025-11-01' \
  --data '{
    "crustdata_company_ids": [631394, 631466],
    "fields": ["basic_info.name", "basic_info.primary_domain"]
  }'

{
    "original_identifier": "631394",
    "internal_id": 631394,
    "data": {
        "crustdata_company_id": 631394,
        "basic_info": {
            "name": "Stripe",
            "primary_domain": "stripe.com"
        }
    }
}

Record trimmed for clarity.

Fields: requested plus defaults

fields accepts dotted leaf paths (headcount.total), whole family names (headcount), or a comma-separated string of either. A family name expands to its entire subtree. The response contains the requested fields plus the default basic_info family — matching the non-batch Company Enrich exactly, including the selectable field list. An unsupported value returns 400 with every selectable field in metadata.available_fields. This request also shows the comma-separated string identifier form:

Request

curl --request POST \
  --url https://api.crustdata.com/batch/company/enrich \
  --header 'authorization: Bearer YOUR_API_KEY' \
  --header 'content-type: application/json' \
  --header 'x-api-version: 2025-11-01' \
  --data '{
    "domains": "stripe.com,openai.com",
    "fields": ["headcount"]
  }'

One record, trimmed — the full headcount family comes back

{
    "original_identifier": "stripe.com",
    "internal_id": 631394,
    "data": {
        "basic_info": { "name": "Stripe", "primary_domain": "stripe.com" },
        "crustdata_company_id": 631394,
        "headcount": {
            "by_function_timeseries": {
                "CURRENT_FUNCTION": {
                    "Accounting": [
                        { "date": "2024-12-01 00:00:00", "employee_count": 222 }
                    ]
                }
            }
        }
    }
}

`chunk_size`

Optional internal processing chunk size (identifiers per processing unit), 10–1000, default 100. Out-of-range values return 400.

Errors

400 — no identifier

{
    "error": {
        "type": "invalid_request",
        "message": "Exactly one identifier must be provided: names, domains, professional_network_profile_urls, or crustdata_company_ids",
        "metadata": []
    }
}

400 — two identifier types

{
    "error": {
        "type": "invalid_request",
        "message": "Only one identifier type can be provided. Found: domains, crustdata_company_ids",
        "metadata": []
    }
}

400 — invalid field (with available_fields)

{
    "error": {
        "type": "invalid_request",
        "message": "Invalid fields: bogus.field",
        "metadata": [
            {
                "available_fields": [
                    "basic_info.name",
                    "basic_info.primary_domain",
                    "headcount.total"
                ]
            }
        ]
    }
}

What to do next

Find companies first — see Batch Company Search to turn one query into an input list.
Single-company enrichment — see Company Enrich.
Resolve a domain to a company first — see Company Identify.
Valid fields values — see the enrich reference.
Enrich people in batch — see Batch Person Enrich.
Full schema — see the API reference.

Documentation

Agents

Products

Skeleton group placeholder 4

Batch Company Enrichment API

Endpoint essentials

Identifiers: exactly one type per job

Your first batch enrichment: companies by domain

Enrich by Crustdata ID

Fields: requested plus defaults

`chunk_size`

Errors

What to do next

​Endpoint essentials

​Identifiers: exactly one type per job

​Your first batch enrichment: companies by domain

​Enrich by Crustdata ID

​Fields: requested plus defaults

​chunk_size

​Errors

​What to do next

Endpoint essentials

Identifiers: exactly one type per job

Your first batch enrichment: companies by domain

Enrich by Crustdata ID

Fields: requested plus defaults

`chunk_size`

Errors

What to do next