# PDL Company Search

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

Search across 30M+ company records using Elasticsearch DSL or SQL queries, returning paginated matching company records with firmographic data.

## Facts

- Endpoint: POST https://stablepeopledata.dev/api/pdl/company/search
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablepeopledata-dev-f1a0b837
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aYogf6YoBtJ9o5RxqLEgv

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-f1a0b837 -d '<json body>'
```

Example prompt: Search the PDL company database for up to 10 software companies headquartered in New York with more than 500 employees — use an Elasticsearch DSL query filtering by industry 'computer software', location 'New York', and employee count greater than 500.

## When to prefer this

Use this endpoint when you need to discover or filter multiple companies matching specific criteria (industry, location, size, etc.) rather than enriching a single known company. Prefer this over PDL Company Enrich when you don't have a specific company identifier and need to find candidates from a broad search. Best for lead generation, market research, and building targeted company lists.

## Known failure modes

- Invalid Elasticsearch DSL or SQL syntax returns a 400 error
- Requested size exceeds account credit balance, resulting in a payment or quota error
- scroll_token expired or invalid causes pagination failure
- No matching companies found returns empty results array
- Unsupported query fields or operators return validation errors

## How this service works

PDL Company Search - Search across 30M+ company records using Elasticsearch DSL or SQL queries. Returns matching company records with pagination via scroll_token. Price scales with the requested `size` (1 PDL credit per result).

## Output

Returns an array of matching company records with firmographic fields such as company name, website domain, industry, employee count, revenue range, funding details, LinkedIn URL, and social profiles, along with a scroll_token for paginating through additional results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sql": {
   "type": "string",
   "description": "SQL query: SELECT * FROM company WHERE ... Do not include LIMIT — use size for result count."
  },
  "size": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Batch size (1-100, default 1)"
  },
  "query": {
   "type": "object",
   "description": "Elasticsearch v7.7 DSL query object",
   "propertyNames": {
    "type": "string"
   },
   "additionalProperties": {}
  },
  "titlecase": {
   "type": "boolean",
   "description": "Titlecase text in response"
  },
  "scroll_token": {
   "type": "string",
   "description": "Pagination token from previous response"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablepeopledata-dev-f1a0b837/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)