Yelp Listing Scraper

Extract detailed information from Yelp business listings effortlessly

API Usage

The Yelp Listing Scraper is also accessible via API, accepting the following parameters in the request body

Request Body

Name	Description	Example
urls	Array of Yelp business listing URLs to scrape data from	["https://www.yelp.com/biz/kyu-miami-4", "https://www.yelp.com/biz/another-listing"]
service_platform	Identifier for the scraper platform	yelp_detail
webhook_url	Optional callback URL to receive results upon job completion (must accept POST requests)	https://yourwebhook.com/endpoint

Authentication

Set the following header for authentication:

Authorization: Token <your_api_key>

Example

To use the scraper via API, send a POST request with the urls and service_platform in the request body.

bash

1curl -X POST 'https://data.unwrangle.com/api/jobs/' \
2-H 'Authorization: Token <your_api_key_here>' \
3-H 'Content-Type: application/json' \
4-d '{
5  "urls": ["https://www.yelp.com/biz/kyu-miami-4", "https://www.yelp.com/biz/another-listing"],
6  "service_platform": "yelp_detail"
7}'

API Response

This is the response you will receive when a scraping job is created successfully.

json

1{
2  "created": "2024-06-10T09:19:40.161178Z",
3  "id": 27602,
4  "url": null,
5  "urls": ["https://www.yelp.com/biz/kyu-miami-4", "https://www.yelp.com/biz/another-listing"],
6  "status": "queued",
7  "n": null,
8  "service_platform": "yelp_detail",
9  "from_date": null,
10  "webhook_url": null,
11  "external_id": null,
12  "is_webhook_sent": false,
13  "credits_used": 10,
14  "completed": null
15}

Querying Results

The results retrieved by the scraping job can also be queried via API by making a request with the job ID if a webhook URL is not provided.

bash

1curl -X GET 'https://data.unwrangle.com/api/jobs/27602/results/' \
2-H 'Authorization: Token <your_api_key>'

Request Cost

Each listing scraped will cost 1 credit and an additional 10 credits will be charged as a base fee for each job that is created