scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTReviews
  • POSTBusiness Profile
  • POSTSearch

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: id, alias, name, rating, reviewCount, categories, priceRange, location, phoneNumber, operationHours, coordinates. Use ["*"] for all. Available fields: id, alias, name, rating, reviewCount, reviewCountsByRating, reviewCountsByLanguage, primaryPhotoUrl, categories, isClosed, isClaimed, yearEstablished, location, phoneNumber, operationHours, priceRange, specialties, summary, ambiance, externalResources, attributes, formattedAddress, coordinates, popularDishes, menu, scrapedAt, and many more.

Response Schema

dataobject

Business profile data

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": {
    "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"
  }
}