Data catalog / directory
Directory data
Search businesses on Yellow Pages by query and location.
Last updated September 23, 2026
How it works
Give it a business type and a location and it scrapes matching Yellow Pages listings — name, phone, address, website, category, and rating. Useful for building a local-business prospect list without a dedicated local-search API.
Reference
| Name | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Business type or name to search, e.g. "plumber". |
location | string | Yes | City, state, or zip code. |
page | integer | No | Page number. Defaults to 1. |
max_pages | integer | No | Maximum number of pages to scrape. Defaults to 1. |
querystring · Required- Business type or name to search, e.g. "plumber".
locationstring · Required- City, state, or zip code.
pageinteger · Optional- Page number. Defaults to 1.
max_pagesinteger · Optional- Maximum number of pages to scrape. Defaults to 1.
Request
Minimum required parameters for a directory data call.
Request
{
"query": "plumber",
"location": "New York, NY"
}See it in a workflow
Playbooks
Real patterns, recipes, and prompts other builders run on RichAPI
Developer Docs
Auth, request shape, and error handling
FAQ
Frequently asked questions
Search businesses on Yellow Pages by query and location.
Every endpoint is billed from the same credit pool, at the published rate on /pricing — never a separate contract per endpoint.
Yes — the same endpoint is reachable from an MCP client (Claude, ChatGPT, Cursor, Windsurf) using the same key and credit pool. See /mcp.
Related data
How to find someone's work emailSend a name and a company domain, or a LinkedIn URL, and get back a work email with a confidence label. The call runs a provider waterfall, cheapest-first, and stops at the first hit. If nobody has the address, the call bills zero credits.How to find someone's LinkedIn profile from their email addressSend an email address and get back the LinkedIn profile URL behind it. The reverse of every other lookup in the catalog, and the first leg of the email-to-person chain. Flat cost per call, billed on any 2xx including a response with no match.How to verify an email address before you sendSend one address and get back a verdict: whether it is valid, whether the domain is disposable, whether an MX record exists, and a status label you can branch on. Runs a provider waterfall. If the waterfall cannot reach a verdict, the call bills zero credits.Enrichment dataDetailed profile data for a LinkedIn person URL — the core enrichment endpoint.