Yelp Scraper

Extract business listings, reviews, and ratings from Yelp

$0.01 per resultPOST /api/v1/scrape/yelp-scraper

Parameters

Name	Type	Required	Description
`searchTerms`	string[]	Optional	Search keywords (pizza, plumber, etc.)Example: ["pizza", "italian restaurant"]
`locations`	string[]	Optional	Cities or areas to searchExample: ["New York, NY", "Brooklyn, NY"]
`directUrls`	string[]	Optional	Direct Yelp business URLs (skips search)Example: ["https://www.yelp.com/biz/joes-pizza-new-york"]
`searchLimit`	number	Optional	Results per search combinationDefault: 10Example: 20

Examples

Search for restaurants in multiple cities

curl -X POST https://app.scrapercity.com/api/v1/scrape/yelp-scraper \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "searchTerms": ["pizza", "burger"],
    "locations": ["New York, NY", "Los Angeles, CA"],
    "searchLimit": 15
  }'

Extract specific businesses

curl -X POST https://app.scrapercity.com/api/v1/scrape/yelp-scraper \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "directUrls": [
      "https://www.yelp.com/biz/curry-leaf-flavors-of-india-las-vegas",
      "https://www.yelp.com/biz/lotus-of-siam-las-vegas"
    ]
  }'

Use Cases

•Local business lead generation
•Restaurant and service provider research
•Competitive analysis and review monitoring
•Market saturation studies by category and location
•Customer sentiment analysis from reviews
•Building local business directories

Best Practices

•Provide EITHER directUrls OR (searchTerms + locations), not both
•Direct URLs skip search and extract specific businesses
•Each search term × location combination counts toward limit
•Returns business details, ratings, review counts, and photos
•Maximum 50 results per search combination
•Can be cancelled while running

Every scrape returns a runId. Poll GET /api/v1/scrape/status/{runId} until it completes, then download via GET /api/downloads/{runId}?format=csv.

Authenticate every request with Authorization: Bearer YOUR_API_KEY. See the full API reference for authentication, rate limits and error codes.

Yelp Scraper API Documentation