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:

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

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.

Request
{
  "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

Start free with 100 credits

Developer Docs

Auth, request shape, and error handling

See Documentation

FAQ

Frequently asked questions

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.
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