POST /api/yellowpages/lists — US businesses from Yellow Pages with the owner, emails, phones, website, socials, categories, rating, years in business and a business summary. Every search term is searched in every location.
| Field | Type | Notes |
|---|---|---|
searchTerms | string[] or string | What to search for, e.g. ["roofing contractors", "plumbers"]. Up to 20. |
locations | string[] or string | US cities, ZIP codes or states, e.g. ["Denver, CO", "90210"]. Up to 20. Terms × locations at most 100. |
urls | string[] or string | Optional Yellow Pages search, category or business links instead of (or as well as) terms. Up to 50. |
maxPerSearch | integer | 1–3,000 businesses per term × location (and per link). Default 30. |
sort | string | default (best match), distance, average_rating or name. |
categories | string[] | Optional: keep only these Yellow Pages categories, e.g. ["Roofing Contractors"]. Any of them matches. Up to 20. |
neighborhoods | string[] | Optional: keep only these neighborhoods. Up to 20. |
bbbRated | boolean | Only businesses rated A or A+ by the Better Business Bureau. |
open24h | boolean | Only businesses open 24 hours. |
verifyEmails | boolean | Check the emails when the search finishes (paid plans; credits per email). |
curl -X POST https://getclient.pro/api/yellowpages/lists \
-H "Authorization: Bearer gc_live_your_key" \
-H "Content-Type: application/json" \
-d '{"searchTerms":["roofing contractors"],"locations":["Denver, CO","Aurora, CO"],"maxPerSearch":30,"sort":"average_rating"}'Then
The response has list.id. Poll GET /api/yellowpages/lists/{id} until list.status is completed (or failed); the results are under businesses. See Search Status, Filter & Paginate and Export CSV.
Credits: one per result found. The most the search could cost is reserved when it starts; what isn't used comes back when it finishes.
AI assistants can run the same search with the MCP tool search_yellow_pages (MCP Server).