Reputation & Reviews

Yellow Pages API

The Yellow Pages API returns US business-directory data as clean JSON.

3 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns businesses with name, URL, YPID, phone, address, categories and rating, and you can pull a detail and browse a category. It is built for lead generation, local-data products and B2B enrichment that need Yellow Pages data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/yellowpages/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "search_terms": "plumber",
    "geo_location_terms": "Austin, TX"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "yellowpages",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 20213.2,
    "record_count": 42,
    "bytes": 291548,
    "cache_hit": false,
    "completeness_pct": 100,
    "stop_reason": "limit_reached",
    "method": "ssr_ldjson",
    "page": 1,
    "total_results": 646,
    "per_page": 30,
    "has_more": true,
    "next_page": 2
  },
  "data": {
    "businesses": [
      {
        "name": "[redacted-name]",
        "url": "https://www.yellowpages.com/nationwide/mip/best-home-savings-[redacted-phone]?lid=[redacted-phone]",
        "ypid": "[redacted-phone]",
        "phone": null,
        "street_address": null,
        "locality": null,
        "categories": [
          "Plumbers",
          "Water Heaters",
          "Plumbing Contractors-Commercial & Industrial"
        ],
        "rating": null,
        "review_count": null,
        "years_in_business": null,
        "snippet": null
      },
      {
        "name": "[redacted-name]",
        "url": "https://www.yellowpages.com/conroe-tx/mip/ars-rescue-rooter-[redacted-phone]?lid=[redacted-phone]",
        "ypid": "[redacted-phone]",
        "phone": "[redacted-phone]",
        "street_address": null,
        "locality": null,
        "categories": [
          "Plumbers",
          "Air Conditioning Contractors & Systems",
          "Furnaces-Heating"
        ],
        "rating": null,
        "review_count": null,
        "years_in_business": null,
        "snippet": null,
        "address": "Conroe, TX 77303",
        "hours": [
          "Mo-Su"
        ]
      },
      {
        "name": "[redacted-name]",
        "url": "https://www.yellowpages.com/austin-tx/mip/ars-rescue-rooter-[redacted-phone]?lid=[redacted-phone]",
        "ypid": "[redacted-phone]",
        "phone": "[redacted-phone]",
        "street_address": null,
        "locality": null,
        "categories": [
          "Plumbers",
          "Air Conditioning Contractors & Systems"
        ],
        "rating": null,
        "review_count": null,
        "years_in_business": null,
        "snippet": null,
        "address": "Austin, TX 78754",
        "hours": [
          "Mo-Su"
        ]
      }
    ]
  }
}

Actions

What the Yellow Pages API does

Action	Description	Concrete use case	Key params
search	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.	Support teams call search to search the Yellow Pages business directory by category/keyword and US location.	search_terms, geo_location_terms, page
detail	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.	Reputation platforms call detail to get full business profile from a Yellow Pages detail URL (the `url` of a search result).	url
category	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.	Market researchers call category to get browse every business in a Yellow Pages category for a US city.	category, location, page

Code samples

Call search from your stack

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"}'

import requests

r = requests.post(
    "https://api.reefapi.com/yellowpages/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "search_terms": "plumber",
  "geo_location_terms": "Austin, TX"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/yellowpages/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "search_terms": "plumber",
  "geo_location_terms": "Austin, TX"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.yellowpages.search with {"search_terms":"plumber","geo_location_terms":"Austin, TX"}.

Use cases

Who uses this API and why

Lead-gen tools call search to build business lists by category and city.
Enrichment uses detail to attach phone and address to a record.
Analysts use category to size a local market.

FAQ

Questions developers ask before integrating

What is the Yellow Pages API?

Yellow Pages API is a ReefAPI endpoint group for yellow pages It returns live JSON through POST requests under /yellowpages/v1.

Is the Yellow Pages API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Yellow Pages calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Yellow Pages login or account?

No login to Yellow Pages is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Yellow Pages data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Yellow Pages API use?

Yellow Pages actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Yellow Pages from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call yellowpages actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Yellow Pages API a Yellow Pages scraper?

It is the managed alternative to a DIY Yellow Pages scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same yellow pages back as clean JSON.

Why does my Yellow Pages scraper keep getting blocked?

Most Yellow Pages scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / yellowpages

Yellow Pages

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
}