Skip to main content
Scrape Yelp businesses (search + detail)

Authorizations

x-scrapeunblocker-key
string
header
required

Your ScrapeUnblocker API key. Apply on every request.

Query Parameters

mode
string
default:search

'search' (find businesses) or 'detail' (one business).

find_desc
string | null

Search keyword or category, e.g. 'coffee' or 'plumbers'.

find_loc
string | null

Location to search, e.g. 'San Francisco, CA' or '94109'.

url
string | null

Detail mode: a Yelp business URL or /biz alias, e.g. 'https://www.yelp.com/biz/gary-danko-san-francisco'.

sort
string
default:recommended

Search ordering: recommended, rating, review_count, distance.

price
string | null

Price filter 1-4 ($ to $$$$); combine like '1,2'.

open_now
boolean
default:false

Search: only businesses open now.

max_results
integer
default:30

Search: how many businesses to collect across pages (10 per page).

Required range: 1 <= x <= 240
start
integer
default:0

Search: result offset to start from.

Required range: x >= 0
proxy_country
string | null

Exit-IP country (ISO-2). Defaults to a US exit for Yelp.

Response

JSON with a businesses array (search) or a business object (detail).