Fetch paginated Yelp customer reviews for a business, including review text, star rating, author profile, reactions, and attached photos or videos. Pass the Yelp business ID (biz_id / encid). Each page returns up to 10 reviews. Browser rendering handles Cloudflare and returns structured JSON.
GET https://api.piloterr.com/v2/yelp/reviews?query=cX5dOMkwZ5rqWbeIJpw_Ig
GET https://api.piloterr.com/v2/yelp/reviews?query=cX5dOMkwZ5rqWbeIJpw_Ig&page=2
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Yelp business ID / encid (e.g. cX5dOMkwZ5rqWbeIJpw_Ig) |
page |
integer |
no |
Page number, 10 reviews per page (default: 1) |
| Field |
Type |
Description |
business_id |
string |
Yelp business encid |
url |
string |
Source Yelp URL |
results |
array |
Review objects |
results[].encid |
string |
Review encid |
results[].rating |
integer |
Star rating (1-5) |
results[].text.full |
string |
Full review text |
results[].text.language |
string |
Review language code |
results[].author.display_name |
string |
Reviewer display name |
results[].author.encid |
string |
Reviewer encid |
results[].author.friend_count |
integer |
Reviewer friend count |
results[].author.review_count |
integer |
Reviewer total reviews |
results[].author.display_location |
string | null |
Reviewer location |
results[].author.business_photo_count |
integer |
Reviewer photo count on businesses |
results[].business.name |
string |
Business name |
results[].business.alias |
string |
Business slug |
results[].business.encid |
string |
Business encid |
results[].feedback |
object |
Legacy reaction counts (useful_count, etc.) |
results[].created_at |
string | null |
Review timestamp when available |
results[].business_photos |
array |
Photos attached to the review |
results[].business_videos |
array |
Videos attached to the review |
results[].available_reactions |
array |
Reaction types with counts |
pagination.current |
integer |
Current page |
pagination.next |
integer | null |
Next page number |
pagination.total_pages |
integer |
Total review pages |
pagination.total_results |
integer |
Total reviews when available |
pagination.has_next_page |
boolean |
Whether another page exists |
- Use
biz_id from Yelp Search or business_id from Yelp Business as query.
- Each page contains up to 10 reviews.
created_at and feedback counts may be null on some reviews.- Photo and video attachments vary per review; arrays may be empty.
- Monitor brand sentiment and review volume over time
- Train NLP models on local business feedback
- Detect reputation issues with paginated review ingestion
- Extract user-generated photos and videos from reviews
