Yelp Reviews

Get reviews for a Yelp business.

GET/api/v1/yelp/reviews

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Business reviews

Fetch public reviews for one encoded Yelp business ID.

Parameter	Type	Description
`place_id`required	string	Required encoded Yelp business identifier.
`yelp_domain`	string	Supported localized Yelp hostname.Default: www.yelp.com.
`hl`	string	Review language such as en or fr-FR.Default: en.
`q`	string	Search review text for these terms.
`sortby`	"relevance_desc" \| "date_desc" \| "date_asc" \| "rating_desc" \| "rating_asc" \| "elites_desc"	Yelp review ordering.Default: relevance_desc.
`rating`	string	Comma-separated ratings from 1 through 5.
`not_recommended`	boolean	Fetch reviews that Yelp does not recommend.Default: false.
`not_recommended_start`	integer	Offset within not-recommended reviews. Requires not_recommended=true.
`start`	integer	Review offset from 0 through 10,000.Default: 0.
`num`	integer	Review count from 1 through 49.Default: 49.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result data: reviews. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/yelp/reviews?place_id=dDz2erKJ_Z2HMur0tQ_iJA" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "place_id": "dDz2erKJ_Z2HMur0tQ_iJA"
});
const res = await fetch(`https://serpfast.com/api/v1/yelp/reviews?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "place_id": "dDz2erKJ_Z2HMur0tQ_iJA"
}
res = requests.get(
    "https://serpfast.com/api/v1/yelp/reviews",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())