Skip to content

Yelp Listing Details API

Scrape detailed Yelp listing information instantly with a simple API call

🆕: February 22, 2025

Get instant access to Yelp listing data with our API.

A GET request to our /api/getter/?platform="yelp_detail" endpoint allows you to scrape listing data for any business listing on Yelp in real-time.

Example

Here's how you can scrape listing data for this listing with our API:

1
curl 'https://data.unwrangle.com/api/getter/?platform=yelp_detail&url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Fkyu-miami-4&api_key=API_KEY'

1
2
3
4
5
import requests

url = 'https://data.unwrangle.com/api/getter/?platform=yelp_detail&url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Fkyu-miami-4&api_key=API_KEY'
response = requests.get(url)
print(response.json())

1
2
3
const response = await fetch('https://data.unwrangle.com/api/getter/?platform=yelp_detail&url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Fkyu-miami-4&api_key=API_KEY')
const data = await response.json()
console.log(data)

1
2
3
4
5
6
<?php
$url = 'https://data.unwrangle.com/api/getter/?platform=yelp_detail&url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Fkyu-miami-4&api_key=API_KEY';
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);
?>

1
2
3
4
5
6
require 'net/http'
require 'uri'

uri = URI.parse('https://data.unwrangle.com/api/getter/?platform=yelp_detail&url=https%3A%2F%2Fwww.yelp.com%2Fbiz%2Fkyu-miami-4&api_key=API_KEY')
response = Net::HTTP.get(uri)
puts response

In this example, we've provided the listing's URL.

Query Parameters

As you can see in the example above, our endpoint needs the following query parameters:

Listing URL

url

Required

Listing's URL on Yelp. Remove unnecessary query parameters and encode the URL.

Other Required Parameters

platform

Required

Specifies the scraping engine you wish to invoke. In this case, the value should be yelp_detail.

api_key

Required

Your account's token—which can be obtained by signing up here.

Note

The value of the query parameter url must be URL or percent encoded. If you're using Python, this can be done with the function urlencode.

Results

The response will include the following attributes for the listing:

Attributes Returned Data Type Information Represented
name string Name of the business listing
rating float Average rating of the listing
total_reviews integer Total number of reviews
price_range string Price range of the business
type string Type or category of business
status string Current open/close status
hours array List of business hours
menu array List of popular menu items
website string URL of the business website
phone string Phone number of the business
address string Address of the business
area string Area or neighborhood
vibe array List describing the vibe
biz_id string Unique identifier of the listing

Response Example

Here's the response you can expect to receive for the request showcased above:

{
    "success": true,
    "url": "https://www.yelp.com/biz/kyu-miami-4",
    "result_count": 1,
    "detail": {
        "name": "Kyu",
        "rating": 4.4,
        "total_reviews": 2000,
        "price_range": "$$$",
        "type": "Asian Fusion",
        "status": "Open now",
        "hours": [
            "Mon: 5:00 PM - 10:00 PM",
            "Tue: 5:00 PM - 10:00 PM",
            "Wed: 12:00 PM - 10:00 PM",
            "Thu: 12:00 PM - 11:00 PM",
            "Fri: 12:00 PM - 11:00 PM",
            "Sat: 12:00 PM - 11:00 PM",
            "Sun: 12:00 PM - 10:00 PM"
        ],
        "menu": [
            {
                "name": "Coconut Cake",
                "image_url": "https://s3-media0.fl.yelpcdn.com/bphoto/zD8YKE4dYudZJ2QRokhYQQ/258s.jpg",
                "image_count": 163,
                "total_reviews": 303
            },
            // ... other menu items ...
        ],
        "website": "https://www.kyurestaurants.com/location/kyu-miami/",
        "phone": "(786) 577-0150",
        "address": "251 NW 25th StMiami, FL 33127",
        "area": "Wynwood",
        "vibe": [
            "Hipster",
            "Trendy",
            "Moderate noise",
            "Happy hour specials",
            "Good for groups",
            "Outdoor seating"
        ],
        "biz_id": "MfkZSdJ0w4-SOLJiEyHU5A"
    },
    "remaining_credits": 3818175.0
}

Request Cost

• 10 credits are deducted for each successful request to Yelp.

Support

If you want to add a parameter to our response or have any other questions or feedback, please write to us at support@unwrangle.com