agntdata Lead APIspost/people/bulk-enrich

Bulk enrich people

People — Enrich
Cost / request

$0.01

Response format

JSON

Protocol

REST

About this endpoint

Enrich up to 100 people in one call. Each record runs the same field-aware waterfall as `/people/enrich`, with a per-record budget cap via `max_cost_cents_per_record`.

Use cases

Batch CRM enrichment jobs
List uploads in lead-gen workflows
Periodic refresh of contact records

Parameters

bodyRequest Bodyrequired

Content type: application/json

Responses

Bulk enrichment results.

{
  "type": "object",
  "required": [
    "success",
    "data"
  ],
  "properties": {
    "success": {
      "type": "boolean",
      "enum": [
        true
      ]
    },
    "data": {
      "$ref": "#/components/schemas/PeopleBulkEnrichResponse"
    },
    "meta": {
      "$ref": "#/components/schemas/AgntMeta"
    }
  }
}

Agent / Developer Schema

Machine-readable formats for integrating this endpoint into AI agents and toolchains.

{
  "operationId": "people_bulk_enrich",
  "method": "post",
  "path": "/people/bulk-enrich",
  "summary": "Bulk enrich people",
  "description": "Enrich up to 100 people in one call. Each input record requires `email` and/or `linkedin_url` (either at the top level of the input object or nested under `identifiers`). `first_name`/`last_name`/`domain` are NOT accepted — if you only have name+company, call `/people/email-finder` per record first. Each input runs the same field-aware waterfall as `/people/enrich`. Use `max_cost_cents_per_record` to cap per-record spend.",
  "parameters": [],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/PeopleBulkEnrichRequest"
        },
        "example": {
          "inputs": [
            {
              "identifier": "row-1",
              "linkedin_url": "https://linkedin.com/in/patrickcollison"
            },
            {
              "identifier": "row-2",
              "email": "elon@spacex.com"
            }
          ],
          "fields": [
            "email",
            "job_title",
            "company_name"
          ]
        }
      }
    }
  },
  "responses": [
    {
      "statusCode": "200",
      "description": "Bulk enrichment results.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "success",
              "data"
            ],
            "properties": {
              "success": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "data": {
                "$ref": "#/components/schemas/PeopleBulkEnrichResponse"
              },
              "meta": {
                "$ref": "#/components/schemas/AgntMeta"
              }
            }
          }
        }
      }
    },
    {
      "statusCode": "400",
      "description": "Validation error."
    },
    {
      "statusCode": "402",
      "description": "Insufficient credits."
    }
  ]
}

Pricing

$0.01per successful request

Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.

Related endpoints

Start using this endpoint

Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.

bulk people enrichment APIbatch enrich contactslead enrichment APIemail finder APIemail verifier API