Yelp Business Profile

1 credit

Get detailed business profile data from Yelp.

POST/api/v1/tools/yelp/business

Parameters

businessstringrequired

Business alias or Yelp URL. Accepts a plain alias like "gary-danko-san-francisco" or a full URL like "https://www.yelp.com/biz/gary-danko-san-francisco".

fieldsstring[]

Fields to include. Omit for defaults: complete, partial, failedSections, id, alias, name, rating, reviewCount, categories, priceRange, location, phoneNumber, operationHours, coordinates. Use ["*"] for all fields.

Response Schema

dataobject

Business profile data

completeboolean

True when all business data sections were collected.

partialboolean

True when one or more business data sections could not be collected.

failedSectionsstring[]

Business data sections that could not be collected.

idstring

Yelp encrypted business ID

aliasstring

URL-safe business alias

namestring

Business display name

ratingnumber

Overall star rating

reviewCountnumber

Total number of reviews

categoriesobject[] | null

Business categories (alias, title)

priceRangestring | null

Price range indicator (e.g. "$$$$")

locationobject | null

Location details (address, neighborhoods, timezone)

phoneNumberstring | null

Phone number

operationHoursobject | null

Business operating hours

coordinatesobject | null

Geographic coordinates (latitude, longitude)

scrapedAtstring

ISO 8601 timestamp when the data was scraped

metaobject

Request metadata

toolstring

Tool name (yelp-business)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/yelp/business \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "business": "gary-danko-san-francisco"
  }'

Response Example

{
  "data": {
    "complete": true,
    "partial": false,
    "failedSections": [],
    "id": "WavvLdfdP6g8aZTtbBQHTw",
    "alias": "gary-danko-san-francisco",
    "name": "Gary Danko",
    "rating": 4.5,
    "reviewCount": 5842,
    "categories": [
      {
        "alias": "newamerican",
        "title": "American (New)"
      },
      {
        "alias": "french",
        "title": "French"
      }
    ],
    "priceRange": "$$$$",
    "location": {
      "address1": "800 N Point St",
      "city": "San Francisco",
      "state": "CA",
      "postalCode": "94109",
      "country": "US"
    },
    "phoneNumber": "+14157492060",
    "operationHours": {
      "regularHours": [
        {
          "dayOfWeek": "WEDNESDAY",
          "openTime": "1700",
          "closeTime": "2200"
        },
        {
          "dayOfWeek": "THURSDAY",
          "openTime": "1700",
          "closeTime": "2200"
        }
      ]
    },
    "coordinates": {
      "latitude": 37.80587,
      "longitude": -122.42058
    },
    "scrapedAt": "2026-04-24T12:00:00.000Z"
  },
  "meta": {
    "tool": "yelp-business",
    "creditsUsed": 1,
    "requestId": "req_abc123"
  }
}

{

"data": {

"complete": true,

"partial": false,

"failedSections": [],

"id": "WavvLdfdP6g8aZTtbBQHTw",

"alias": "gary-danko-san-francisco",

"name": "Gary Danko",

"rating": 4.5,

"reviewCount": 5842,

"categories": [

{

"alias": "newamerican",

"title": "American (New)"

{

"alias": "french",

"title": "French"

}

"priceRange": "$$$$",

"location": {

"address1": "800 N Point St",

"city": "San Francisco",

"state": "CA",

"postalCode": "94109",

"country": "US"

"phoneNumber": "+14157492060",

"operationHours": {

"regularHours": [

{

"dayOfWeek": "WEDNESDAY",

"openTime": "1700",

"closeTime": "2200"

{

"dayOfWeek": "THURSDAY",

"openTime": "1700",

"closeTime": "2200"

}

]

"coordinates": {

"latitude": 37.80587,

"longitude": -122.42058

"scrapedAt": "2026-04-24T12:00:00.000Z"

"meta": {

"tool": "yelp-business",

"creditsUsed": 1,

"requestId": "req_abc123"

}