Search Yelp for local businesses and retrieve paginated listing cards with ratings, review counts, categories, price range, photos, sponsored flags, and business links. Pass a full Yelp search URL (find_desc + find_loc). Piloterr handles Cloudflare protection via browser rendering and returns structured JSON.
GET https://api.piloterr.com/v2/yelp/search?query=https%3A%2F%2Fwww.yelp.com%2Fsearch%3Ffind_desc%3DCocktail%2BBars%26find_loc%3DSan%2BFrancisco%252C%2BCA
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Full Yelp search URL (https://www.yelp.com/search?find_desc=...&find_loc=...) |
| Field |
Type |
Description |
results |
array |
Matching business cards |
results[].link |
string |
Yelp business or ad redirect URL |
results[].name |
string |
Business display name |
results[].alias |
string |
Yelp business slug |
results[].biz_id |
string |
Yelp business encid |
results[].is_ad |
boolean |
Whether the card is a sponsored ad |
results[].phone |
string | null |
Phone number when shown on the card |
results[].rating |
number |
Average star rating |
results[].review_count |
integer |
Total review count |
results[].picture |
string |
Thumbnail image URL |
results[].categories |
array |
Category labels |
results[].price_range |
string | null |
Price indicator ($ to $$$$) |
pagination.current |
integer |
Current page |
pagination.next |
integer | null |
Next page number |
pagination.total_pages |
integer |
Total pages |
pagination.other_pages |
array |
Other page numbers |
pagination.has_next_page |
boolean |
Whether another page exists |
pagination.total_results |
integer |
Total results when available |
- Sponsored listings (
is_ad: true) use Yelp ad redirect URLs; organic results link directly to /biz/ pages.
phone may be null on organic cards even when available on the business profile.- Pass an organic
results[].link (/biz/ URL) to Yelp Business, or results[].biz_id to Yelp Reviews.
- Build local business lead lists by category and city
- Monitor competitor ratings and review counts at scale
- Feed sales prospecting tools with Yelp search cards
- Paginate through Yelp result pages programmatically
