# PDL People Enrichment API

> PDL People Enrichment API is a paid API for AI agents from stable-enrich-git-shafu-pdl-people-enrich-25cca0-merit-systems.vercel.app, paid per call via x402, $0.28/call, status unknown (last checked 2026-09-16).

Enriches a person's profile with career history, email addresses, and phone numbers using People Data Labs data, given an email, LinkedIn URL, or name plus company.

## Facts

- Endpoint: POST https://stable-enrich-git-shafu-pdl-people-enrich-25cca0-merit-systems.vercel.app/api/pdl/people-enrich
- Price: $0.28/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pdl-people-enrichment-api-5e90555a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fTK1pd_4T-wVboAGM0sBz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pdl-people-enrichment-api-5e90555a -d '<json body>'
```

Example prompt: Can you enrich the profile for jane.doe@acme.com using People Data Labs — I need her career history, phone number, and any other emails on file?

## When to prefer this

Use this endpoint when you need to enrich a known person's professional profile — especially when you have their email address (highest match rate) or LinkedIn URL. It is the right choice for CRM enrichment, sales prospecting, recruiting research, or any workflow requiring structured career history and contact data. Prefer email input when available; fall back to LinkedIn profile URL or name plus company domain. Do not use for company/org lookups or bulk batch enrichment — this endpoint is optimized for single-person resolution.

## Known failure modes

- Insufficient input (e.g. first_name + last_name alone without company) returns HTTP 400
- No match found returns HTTP 200 with status 404 and data: null (not billed)
- Invalid LinkedIn URL or malformed email may return no match
- Rate limiting or authentication errors may return 4xx/5xx responses
- Person exists in PDL database but with limited data fields populated

## How this service works

PDL Person Enrich — career history, emails, phone. Requires one of: `email`, `profile` (LinkedIn URL), or `first_name` + `last_name` + (`company_name` OR `company_domain`). `{ first_name, last_name }` alone returns 400. Prefer `email` when known, then `profile`. No match: HTTP 200, status 404, data null — not billed. Match: $0.28.

## Output

Returns a structured person profile including full career history (employer names, titles, date ranges), known email addresses, phone numbers, education, and social profiles. If no match is found, returns HTTP 200 with a 404 status and null data — no charge applies. A successful match costs $0.28 per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "email": {
       "type": "string",
       "description": "Email address — highest-reliability input; prefer over profile/name when known."
      },
      "profile": {
       "type": "string",
       "description": "LinkedIn or other social profile URL. Similar coverage to name+domain — not a fallback when person is absent (data: null)."
      },
      "last_name": {
       "type": "string",
       "description": "Last name."
      },
      "first_name": {
       "type": "string",
       "description": "First name."
      },
      "company_name": {
       "type": "string",
       "description": "Company name (with first_name + last_name). Fallback; similar coverage to profile."
      },
      "company_domain": {
       "type": "string",
       "description": "Company domain (with first_name + last_name). Fallback; similar coverage to profile."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pdl-people-enrichment-api-5e90555a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stable-enrich-git-shafu-pdl-people-enrich-25cca0-merit-systems.vercel.app](https://www.zero.xyz/host/stable-enrich-git-shafu-pdl-people-enrich-25cca0-merit-systems.vercel.app/llms.txt)