POST /api/yelp/lists — Yelp businesses with the owner, emails, phone, website, socials, rating, reviews 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. ["plumbers", "drain cleaning"]. Up to 20. |
locations | string[] or string | Cities, neighbourhoods or ZIP codes. Up to 20. Terms × locations at most 100. |
urls | string[] or string | Optional Yelp search or business links instead of (or as well as) terms. Up to 50. |
maxPerSearch | integer | 1–240 businesses per term × location (and per link). Default 30. |
curl -X POST https://prospectcheap.com/api/yelp/lists \
-H "Authorization: Bearer pc_live_your_key" \
-H "Content-Type: application/json" \
-d '{"searchTerms":["plumbers"],"locations":["Austin, TX","Round Rock, TX"],"maxPerSearch":30}'Then
The response has list.id. Poll GET /api/yelp/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.