# PDL Company Enrich

> PDL Company Enrich is a paid API for AI agents from stablepeopledata.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14, last successful call 2026-07-21).

Enrich a company record with firmographics, industry codes, funding data, and social profiles using name, website, ticker, LinkedIn URL, or PDL ID as a lookup key.

## Facts

- Endpoint: POST https://stablepeopledata.dev/api/pdl/company/enrich
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Last successful call: 2026-07-21
- Success rate: 80% of calls made through Zero
- Rating: 4.7 / 5 from 2 reviews
- Activations on Zero: 5
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablepeopledata-dev-80faa5e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rySGlRNIguY0Pa1BDnwCt

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 stablepeopledata-dev-80faa5e4 -d '<json body>'
```

Example prompt: Can you pull the full company profile for Stripe — their industry codes, headcount, funding history, and LinkedIn URL — using their website stripe.com as the lookup key?

## When to prefer this

Use this endpoint when you need to enrich a single known company record with structured firmographic, funding, and social data and you already have at least one identifier (name, website, ticker, LinkedIn URL, or PDL ID). Prefer this over a search endpoint when you have a specific company in mind rather than querying across many companies.

## Known failure modes

- Company not found in PDL database — returns empty or null result
- Ambiguous company name with multiple matches — may return wrong record
- Invalid or unrecognized lookup identifier — returns error
- Insufficient credits or payment failure — returns 402 or authorization error
- Rate limiting — returns 429 if too many requests in short period

## How this service works

PDL Company Enrich - Enrich a company record with firmographics, industry codes, funding, and social profiles. Supports lookup by name, website, ticker, LinkedIn, or PDL ID.

## Output

A structured company record containing firmographic fields such as company name, website, employee count, industry codes (SIC/NAICS), headquarters address, founding year, funding rounds, total funding amount, and social profile URLs (LinkedIn, Twitter, etc.).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Company name"
  },
  "pdl_id": {
   "type": "string",
   "description": "PDL company ID or LinkedIn slug"
  },
  "region": {
   "type": "string",
   "description": "HQ state or province"
  },
  "ticker": {
   "type": "string",
   "description": "Stock ticker symbol"
  },
  "country": {
   "type": "string",
   "description": "HQ country"
  },
  "profile": {
   "type": "string",
   "description": "Social profile URL"
  },
  "website": {
   "type": "string",
   "description": "Company domain"
  },
  "locality": {
   "type": "string",
   "description": "HQ city"
  },
  "location": {
   "type": "string",
   "description": "HQ location (street address to country)"
  },
  "required": {
   "type": "string",
   "description": "Boolean expression of required fields"
  },
  "titlecase": {
   "type": "boolean",
   "description": "Titlecase text"
  },
  "postal_code": {
   "type": "string",
   "description": "HQ postal code"
  },
  "data_include": {
   "type": "string",
   "description": "Fields to include/exclude"
  },
  "min_likelihood": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1,
   "description": "Minimum confidence (1-10, default 2)"
  },
  "street_address": {
   "type": "string",
   "description": "HQ street address"
  },
  "include_if_matched": {
   "type": "boolean",
   "description": "Show matched input fields"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablepeopledata-dev-80faa5e4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablepeopledata.dev](https://www.zero.xyz/host/stablepeopledata.dev/llms.txt)