Data catalog / directory
Directory data
Search Yellow Pages by business type and location and get back each listing's name, phone, address, website and categories, at 0.01 credits per business.
In short: RichAPI POST /directory_yellowpages searches Yellow Pages by search_query (business type or name) and location (city, state or ZIP code), with page and max_pages for pagination. It returns businesses with name, phone, address, website and categories. Billing is 0.01 credits per business returned, so 1,000 listings cost 10 credits. Authentication is an x-api-key header against https://api.richapi.ai/api/v1.
Last updated October 6, 2026
Local businesses from Yellow Pages
POST /directory_yellowpages runs a Yellow Pages search and returns the listings as JSON. Send search_query (a business type such as "plumbers", or a business name) and location (a city, state or ZIP code). Each listing comes back with its name, phone number, address, website and categories.
Results come in pages. max_pages sets how many pages one call reads, and page sets where it starts, so you can split a large area into several calls.
What a Yellow Pages search costs
0.01 credits per business returned. 1,000 listings cost 10 credits, so the cost of the search itself rarely matters. Budget for the calls you make afterwards on the rows you keep.
Rate
| Endpoint | What it does | Credits | Billed |
|---|---|---|---|
/directory_yellowpages |
Search Yellow Pages for businesses with name, phone, address, website, and categories. | 0.01 | per result |
Rates are read from the live OpenAPI spec. Credits are prepaid and never expire, and the price of a credit depends on your package: see pricing.
Yellow Pages or Google Maps
The catalog has two local-business sources. Pick by what you need from the row:
| Yellow Pages | Google Maps | |
|---|---|---|
| Rate | 0.01 credits per business | 0.1 credits per place |
| Input | business type and location | keyword and location, or a Maps search URL |
| Reviews | no | rating, review count, and a separate reviews endpoint |
Use Yellow Pages for cheap, wide coverage of a category in an area. Use Google Maps when ratings and reviews are part of how you qualify a business, as in ranking local businesses by their reviews.
From a listing to a contact
A listing gives you a business, a phone number and usually a website. From the website:
- Extract emails from the site. It crawls a few pages and returns the addresses it finds.
- Detect the tech stack to qualify on what the business runs.
- Clean the website into a root domain before you match it to anything else. Clean a domain, then enrich the company explains the gap you hit there: company enrichment takes a LinkedIn page, not a domain.
Local businesses from Google Maps into your CRM shows the whole flow from a search to CRM rows. The same steps apply to Yellow Pages listings.
Reference
| Name | Type | Required | Description |
|---|---|---|---|
location | string | Yes | City, state, or ZIP code. |
search_query | string | Yes | Business type or name to search for. |
max_pages | integer | No | Maximum number of pages to scrape. |
page | integer | No | Page number for pagination (default 1). |
locationstring · Required- City, state, or ZIP code.
search_querystring · Required- Business type or name to search for.
max_pagesinteger · Optional- Maximum number of pages to scrape.
pageinteger · Optional- Page number for pagination (default 1).
Request
Minimum required parameters for a directory data call.
{
"search_query": "plumbers",
"location": "Austin, TX",
"max_pages": 2
}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
