All tools

Search companies

Returns up to 100 company records per call that match an Elasticsearch or SQL query over PDL's company fields, such as industry, size, location and funding.

View on GitHub
Updated Sep 27, 2026Available asAPI

Description

Send either `query` (Elasticsearch) or `sql`. Each record returned costs one credit, so set `size` (1 to 100, default 1) and page with `scroll_token`.

search-companies.md

Search companies

Returns up to 100 company records per call that match an Elasticsearch or SQL query over PDL's company fields, such as industry, size, location and funding.

Send either query (Elasticsearch) or sql. Each record returned costs one credit, so set size (1 to 100, default 1) and page with scroll_token.

Set up

Use the first option your agent supports.

API (official)

Before doing anything else, make one read-only call to confirm access.

Rules

  • Ask the user before anything that sends messages, costs money, or changes data.
  • Never print API keys.

Built from these files in the repository

The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.

Ways in

RouteSourceCallRequiredDocs
APIOfficialPOST /v5/company/searchAPI key in $PDL_API_KEYDocs

Workflows using Search companies