docs / yellowpages

Yellow Pages API

base /yellowpages/v13 endpoints

post/yellowpages/v1/search1 credit

Search the Yellow Pages business directory by category/keyword and US location. Returns up to 30 businesses per page with name, phone, address, categories, star rating, review count, years in business, a 'From Business' snippet and the detail URL. Paginate with `page`; meta.total_results gives the full match count.

Parameter		Allowed / range	Description
search_terms	required	—	What to look for — a business category, service or name ('plumber', 'italian restaurant', 'dentist', 'Joe's Pizza').
geo_location_terms	required	—	Where to search — a US 'City, ST', a ZIP code, or a neighborhood ('Austin, TX', '90210', 'Brooklyn, NY').
page = 1	optional	1–100	Result page (30 businesses per page). Page until meta.total_results is covered.

Try in playground →

post/yellowpages/v1/detail1 credit

Full business profile from a Yellow Pages detail URL (the `url` of a search result): name, description, full address, geo coordinates, phone, website, email, rating + review count, years in business / founding year, payment methods, languages, opening hours, the list of services offered and recent customer reviews.

Parameter		Allowed / range	Description
url	required	—	The Yellow Pages business detail (/mip/) URL, taken from a search result's `url` field.

Try in playground →

post/yellowpages/v1/category1 credit

Browse every business in a Yellow Pages category for a US city — e.g. all restaurants in Chicago, all dentists in Miami. Same business fields as search, paginated. Use this when you want a city-wide category list rather than a keyword search.

Parameter		Allowed / range	Description
category	required	—	Category slug as it appears on Yellow Pages ('restaurants', 'dentists', 'auto-repair', 'plumbers').
location	required	—	US city as 'City, ST' (e.g. 'Chicago, IL', 'Miami, FL').
page = 1	optional	1–100	Result page (30 businesses per page). Page until meta.total_results is covered.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/yellowpages/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"search_terms":"plumber","geo_location_terms":"Austin, TX"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}