InsightSocial

Yelp scraper API

The InsightSocial Yelp API has 4 endpoints, from 20 credits a call. A business call costs 40 credits, about $0.04 on Pro, and your first 10 calls up to 100 credits each are free.

The Yelp scraper API for local businesses, as JSON: details with address, phone, hours and rating, public reviews page by page, photos, and business search by category and location.

4 endpoints · from 20 credits a call · 10 free calls up to 100 credits each · no credit card

curl "https://api.insightsocial.app/v1/yelp/business?alias=example-coffee-roasters-san-francisco" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "yelp",
"endpoint": "/v1/yelp/business",
"schema_version": "2",
"data": {
"alias": "example-coffee-roasters-san-francisco",
"business_id": "AbCdEf0123456789",
"name": "Example Coffee Roasters",
"url": "https://www.yelp.com/biz/example-coffee-roasters-san-francisco",
"rating": 4.5,
"review_count": 1287,
"is_claimed": true,
"is_closed": false,
"price_range": "$$",
"phone": "+14155550100",
"website": "https://example.com",
"address": {
"city": "San Francisco",
"region": "CA",
"postal_code": "94103",
"country": "US"
},
"categories": [
{
"alias": "coffee",
"title": "Coffee & Tea"
}
]
},
"unavailable": [],
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

What Yelp data can you get?

Public Yelp data only, in the same JSON envelope as every other platform. Every Yelp endpoint is beta: inside data it returns Yelp's own structure under our naming rules (snake_case keys, string ids, ISO times where Yelp gives a timestamp), not the shared profile and post schema, and fields may change.

Businesses

A business by alias or URL: rating, review count, price range, phone, website, address, coordinates, categories, opening hours and amenities.

Reviews

Public reviews page by page, from the recommended reviews or the ones Yelp does not recommend.

Photos and search

A business's public photos, and businesses by name, service or category near a place, in Yelp's order, highest rated or most reviewed.

What people build with the Yelp API

  • Local lead lists

    Search a category in a city, then read each business for its phone, website and address.

  • Review analysis

    Read every public review of your locations and your competitors', and compare what customers praise or complain about.

  • Market mapping

    Map the businesses in a category across neighbourhoods with their rating, review count and price range.

Yelp API endpoints

All 4 Yelp endpoints and their price in credits. Every one has a fixed price.

EndpointCreditsWhat it returns
/business40Get public details for a Yelp business.
/business/photos40List public photos for a Yelp business.
/business/reviews40List public reviews for a Yelp business.
/businesses/search20Search Yelp businesses by name, category, or location.

Parameters, response fields and examples for each endpoint are in the Yelp API reference.

InsightSocial vs the official Yelp API

Yelp's own API (Yelp Fusion) needs a Yelp developer account and API key, and returns up to three review excerpts per business.

InsightSocial APIOfficial Yelp API
ReviewsEvery public review, page by pageUp to three review excerpts
SetupSign in and copy a keyA Yelp developer account and API key
Cost per call40 creditsOn Yelp's own terms; needs a Yelp API key

The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.

How much does the Yelp API cost?

Yelp calls start at 20 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 250 businesses at 40 credits each.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Repeats and retries

    A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.

  • One balance

    API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.

Not writing code?

Connect InsightSocial to Claude or ChatGPT and ask for Yelp data in plain English. Same account, same credits.

Use it from Claude or ChatGPT

Yelp API: frequently asked questions

Yes. /v1/yelp/business/reviews pages through a business's public reviews. Set category to recommended for the reviews Yelp shows by default, or not_recommended for the ones it filters out.