POST /directory_yellowpages • Credits: 0.01 credits per business returned

Yellow Pages Search finds businesses in the Yellow Pages directory by keyword and location. It returns a JSON object with a data.businesses array. Each business holds a name, a phone number, an address, a website, categories and a rating. One POST call costs 0.01 credits per business returned, which is $0.0002 per business.

Local sales teams need the phone number and the website of every business of one type in one city. Yellow Pages Search builds that list from the Yellow Pages business directory at yellowpages.com. Send a business type such as "plumber" and a location such as "Austin, TX". RichAPI runs the directory search, reads the result pages, and returns one object per business. The data source is the public Yellow Pages listing, so the phone number, the address and the categories come from the directory entry. At 0.01 credits per business, Yellow Pages Search is the cheapest per-result endpoint in RichAPI.

Yellow Pages Search accepts the POST method only. If you send GET, the API returns 405.

search_query and location carry no default value. If you omit either one, the API returns 400 with the message Missing required field: search_query or Missing required field: location.

If page falls outside the range 1 to 20, the API returns 400 with the message page must be between 1 and 20. If max_pages falls outside the range 1 to 10, the API returns 400 with the message max_pages must be between 1 and 10.

Yellow Pages Search rejects every parameter name that is not in the table above. An unknown name returns 400 with the message Unknown input field(s), and the response lists the accepted names in supported_fields.

CAUTION: Do not send query or cache in the request body. The API rejects both names with 400 and charges no credits.

max_pages is the volume control for Yellow Pages Search. One call reads the result pages from page up to page + max_pages - 1. A call with page: 1 and max_pages: 3 reads pages 1, 2 and 3. The response holds every business from the three pages in one data.businesses array.

When a result page holds no business, Yellow Pages Search stops early. The response then holds the businesses from the earlier pages only. To walk a large city in several calls, raise page by the max_pages value of the previous call.

Yellow Pages Search returns a JSON object with a data block and a meta block. This example shows a response for the search "plumber" in Austin, TX.

The third business in the example holds an empty website value and an empty rating value. Yellow Pages Search always returns all six business keys. When the directory entry carries no value for a field, the value is an empty string or an empty array.

Yellow Pages Search costs 0.01 credits per business returned. There is no base charge per call. At $0.02 a credit, the rate on the 1,000 and 5,000 credit packs, one business costs $0.0002. Larger packs cost less per credit. A call that returns 100 businesses costs 100 x 0.01 = 1 credit. That is $0.02.

Cost of one call, by the number of businesses returned:

Cost of a lead list, across many calls:

Before the call, RichAPI reserves 10 x max_pages x 0.01 credits against the organization's credit balance. A call with max_pages: 3 reserves 0.3 credits. After the call, RichAPI charges 0.01 credits for each business in the response and releases the rest of the reservation. A call that returns zero businesses costs zero credits.

Yellow Pages Search and Google Maps Places (Keyword) API both return local businesses by keyword and location. Yellow Pages Search costs 0.01 credits per business. Google Maps Places (Keyword) costs 0.1 credits per business. Yellow Pages Search is ten times cheaper for the same kind of record.

Use Yellow Pages Search for bulk United States local lead generation. The cost per business is $0.0002, so a 100,000-record list costs $20.00. Use Google Maps Places (Keyword) for a business outside the United States. Use it also for the review count, the Google place ID and the split address.

Bulk local lead generation is the core use case for Yellow Pages Search. One call returns every business of one type on the result pages that you request, with a phone number and a website for each.

To cover a state, send one call per city instead of one call for the state. To find email addresses for the list, pass each website value to the Website Email Extractor API. To add company data to each website, pass the same value to the Website Intelligence API.

Yellow Pages Search caches every successful response for 24 hours. The cache key holds the search_query value, the location value, the page value and the max_pages value. A repeat call with the same four values returns the cached businesses and sets meta.cache_hit to true. The cache is always on, and no parameter turns it off.

CAUTION: A cache hit costs the same credits as a live read. RichAPI bills 0.01 credits per business on a cached response.

RichAPI refunds the credit reservation for every response outside the 200 range. A 400, 429 or 500 response costs no credits.

A failed directory read does not always return an error status. Yellow Pages Search returns 200 with an empty data.businesses array and a meta.quality_warning value. That response costs zero credits.

One Yellow Pages business record costs 0.01 credits, which is $0.0002. Yellow Pages Search charges no base credit per call, so a call that returns zero businesses costs zero credits.

Yellow Pages Search reads the public Yellow Pages directory, and Google Maps Places (Keyword) runs a Google Maps crawl. Yellow Pages Search costs 0.01 credits per business, and Google Maps Places (Keyword) costs 0.1 credits per business. For bulk United States local lead generation, Yellow Pages Search costs ten times less.

Yellow Pages Search reads up to 10 result pages in one call, and it returns every business on those pages. max_pages sets the page count, and the valid range is 1 to 10. The exact business count per page depends on the Yellow Pages result page.

No. The Yellow Pages listing holds a phone number, an address and a website, and not an email address. To find email addresses, pass each website value to the RichAPI Website Email Extractor endpoint.

No. Send search_query, location, page and max_pages. A request body with query returns 400.

Yellow Pages Search always returns all six business keys. When the Yellow Pages listing carries no website, the website value is an empty string. The rating, phone and address values behave the same way.

No. Yellow Pages Search caches every successful response for 24 hours, and no parameter turns the cache off. A request body with cache returns 400, because cache is not an accepted parameter name.

Yellow Pages Search reads yellowpages.com, which lists United States businesses. For a business outside the United States, use the RichAPI Google Maps Places (Keyword) endpoint.