{ "url": "https://telipot.com/catalog/capabilities/people.enrich.bulk", "id": "people.enrich.bulk", "description": "Profiles of up to ten people from names, emails or LinkedIn URLs in one call", "platform": "people", "providers": [ { "slug": "apollo", "name": "Apollo" } ], "tasks": 1, "taskPages": [ { "id": "apollo.people.enrich.bulk", "name": "Up to 10 people's titles, work emails from emails or names", "provider": { "slug": "apollo", "name": "Apollo" }, "capability": "people.enrich.bulk", "platform": "people", "kind": "data", "tier": "core", "identity": "key", "identityLabel": "Your plan", "price": { "type": "per_result", "confidence": "documented", "source": "docs", "sourceUrl": "https://docs.apollo.io/docs/api-pricing", "checked": "2026-10-05", "note": "1 credit per person when credit-consuming data (demographics or email) is found, 0 for an unmatched person. The docs give 1-9 credits per person: +8 when a mobile phone is returned, and waterfall enrichment costs more. This task sends no phone, personal-email or waterfall option, so it is priced at the 1-credit base per person. credits_consumed reports what the call used and can be a decimal.", "settles": "The charge Apollo reports in credits_consumed", "state": "paid", "label": "$0.0196 / result", "amount": "$0.0196", "unit": "result", "usdPerUnit": { "floor": 0.0196, "ceiling": 0.0196 }, "native": { "text": "1 credit per result", "figure": "1 credit", "per": "result", "currency": "credits" }, "detail": "1 credit · docs" }, "providers": 1, "retention": "standard", "runsOn": "byoc", "live": true, "summary": "Use the bulk people enrichment endpoint to enrich data for up to ten people with a single API call.", "method": "POST", "path": "/people/bulk_match", "host": "https://api.apollo.io/api/v1", "docsUrl": "https://docs.apollo.io/reference/bulk-people-enrichment", "auth": { "scheme": "api_key", "label": "api_key · in header as x-api-key", "short": "api_key · x-api-key" }, "scope": "any_account", "principal": "organization", "requiredScopes": [], "verification": { "state": "untestable", "label": "Untestable", "detail": "Needs specific people and answers with their profiles and work emails; a contact lookup, so it has no test request." }, "input": [ { "name": "details", "location": "body", "type": "array", "required": true, "constraints": [ "1 to 10" ], "note": "One object per person, up to 10, each with any of first_name, last_name, name, email, hashed_email, organization_name, domain, id, linkedin_url. More fields improve the match; a name without a domain or email may match nothing." } ], "sampleInput": { "details": "
" }, "inputSchema": { "type": "object", "properties": { "details": { "type": "array", "description": "One object per person, up to 10, each with any of first_name, last_name, name, email, hashed_email, organization_name, domain, id, linkedin_url. More fields improve the match; a name without a domain or email may match nothing.", "minItems": 1, "maxItems": 10 } }, "required": [ "details" ], "additionalProperties": false }, "output": [ { "name": "request_id", "type": "integer", "description": "A signed 64-bit integer that may be negative." }, { "name": "status", "type": "string", "description": "success for any 200 response, even when not every person matched." }, { "name": "error_code", "type": "string | null" }, { "name": "error_message", "type": "string | null" }, { "name": "total_requested_enrichments", "type": "integer", "description": "The number of objects sent in details. Always returned." }, { "name": "unique_enriched_records", "type": "integer", "description": "Distinct people whose enrichment consumed credits; a billing count, not a match count." }, { "name": "missing_records", "type": "integer", "description": "Entries in details that Apollo could not match." }, { "name": "credits_consumed", "type": "number", "description": "Credits the request consumed; can be a decimal." }, { "name": "matches", "type": "object | null[]" } ], "outputSchema": { "type": "object", "required": [ "status", "total_requested_enrichments" ], "properties": { "request_id": { "type": "integer", "description": "A signed 64-bit integer that may be negative." }, "status": { "type": "string", "description": "success for any 200 response, even when not every person matched." }, "error_code": { "type": [ "string", "null" ] }, "error_message": { "type": [ "string", "null" ] }, "total_requested_enrichments": { "type": "integer", "description": "The number of objects sent in details. Always returned." }, "unique_enriched_records": { "type": "integer", "description": "Distinct people whose enrichment consumed credits; a billing count, not a match count." }, "missing_records": { "type": "integer", "description": "Entries in details that Apollo could not match." }, "credits_consumed": { "type": "number", "description": "Credits the request consumed; can be a decimal." }, "matches": { "type": "array", "items": { "type": [ "object", "null" ], "description": "One entry per person; an unmatched person is null.", "properties": { "id": { "type": "string" }, "first_name": { "type": "string" }, "last_name": { "type": "string" }, "name": { "type": "string" }, "linkedin_url": { "type": "string" }, "title": { "type": "string" }, "headline": { "type": "string" }, "email": { "type": "string" }, "email_status": { "type": "string" }, "organization_id": { "type": "string" }, "match_confidence": { "type": "string", "enum": [ "high", "medium", "low", "none" ] }, "employment_history": { "type": "array", "items": { "type": "object", "properties": { "organization_id": { "type": "string" }, "organization_name": { "type": "string" }, "title": { "type": "string" }, "start_date": { "type": "string" }, "current": { "type": "boolean" } } } }, "state": { "type": "string" }, "city": { "type": "string" }, "country": { "type": "string" }, "seniority": { "type": "string" }, "departments": { "type": "array", "items": { "type": "string" } }, "functions": { "type": "array", "items": { "type": "string" } }, "organization": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "website_url": { "type": "string" }, "primary_domain": { "type": "string" }, "industry": { "type": "string" }, "estimated_num_employees": { "type": "integer" } } } } } } } }, "commands": { "mode": "run", "cli": "telipot run apollo.people.enrich.bulk \\\n --input-json '{\"details\":\"
\"}'", "http": "curl https://api.telipot.com/v1/tasks/apollo.people.enrich.bulk/run \\\n -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"details\":\"
\"}'", "quote": "telipot run apollo.people.enrich.bulk \\\n --input-json '{\"details\":\"
\"}' \\\n --quote" }, "siblings": [] } ] }