yelp_scraper
Extract Yelp business listings by keyword and location, with category, sort, attribute filters, and pagination support.
Instructions
Extract business listings from Yelp by keyword and location, with support for category filters, sorting, attribute filters, and pagination. [Credits: 4 credits per successful request] Notes: Pagination uses the 'start' offset param in increments of 10 (matches Yelp's own pagination scheme); response includes a pagination.next URL. yelp_domain allows targeting international Yelp TLDs. Returns: Object with: filters { category[]: {text,value}, price[]: {text,value}, distance[]: {text,value} }, inline_ads[], sponsored_ads[]: {title,url,rating,review_count,price,categories[],neighborhood}, organic_results[]: {title,url,rating,review_count,price,categories[],neighborhood,thumbnail}, pagination: {next}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| l | No | Distance or map radius string to narrow results by geographic area. | |
| cflt | No | Category filter to narrow results to a specific Yelp category (e.g., 'restaurants', 'bars'). | |
| attrs | No | Refine results by business attributes (e.g., 'GoodForKids', 'WheelchairAccessible'). | |
| start | No | Pagination offset. Use multiples of 10 to paginate through results (e.g., 10, 20). (default: 0) | |
| sortby | No | Sort method for results. Accepted values: recommended, rating, review_count. (default: recommended) | |
| find_loc | Yes | Target location for the search (e.g., 'San Francisco, CA'). | |
| find_desc | No | The search query term (e.g., 'burger', 'pizza', 'coffee'). | |
| yelp_domain | No | The Yelp domain to scrape (e.g., 'yelp.com', 'yelp.co.uk'). |