Yelp Reviews
Fetch paginated Yelp reviews for a business with rating, text, author profile, reactions, and attached photos or videos.
Credit cost: 2 credits per call
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
query*string
Yelp business ID / encid.
Example:
cX5dOMkwZ5rqWbeIJpw_Ig
Use biz_id from Yelp Search or business_id from Yelp Business.
page?number
Page number. Each page returns up to 10 reviews. Default: 1.
Default
"1"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.piloterr.com/v2/yelp/reviews?query=string"{
"url": "https://www.yelp.com/biz_photos/cX5dOMkwZ5rqWbeIJpw_Ig",
"results": [
{
"text": {
"full": "Superb cocktails and friendly service \nDecor are modern and sleek \nCrabcakes and Turkish chicken legs are delicious",
"language": "en"
},
"encid": "ftgDNwNVnb3xwx8XRP9n9Q",
"author": {
"encid": "fFv3wzMIZDgIruoiVOFEGQ",
"display_name": "Yim C.",
"friend_count": 1,
"review_count": 6,
"display_location": "San Francisco, CA",
"business_photo_count": 0
},
"rating": 5,
"business": {
"name": "Novela",
"alias": "novela-san-francisco-2",
"encid": "cX5dOMkwZ5rqWbeIJpw_Ig"
},
"feedback": {
"cool_count": null,
"funny_count": null,
"useful_count": null
},
"created_at": null,
"business_photos": [],
"business_videos": [],
"available_reactions": [
{
"count": 0,
"display_text": "Helpful",
"reaction_type": "HELPFUL"
},
{
"count": 0,
"display_text": "Thanks",
"reaction_type": "THANKS"
},
{
"count": 1,
"display_text": "Love this",
"reaction_type": "LOVE_THIS"
},
{
"count": 0,
"display_text": "Oh no",
"reaction_type": "OH_NO"
}
]
},
{
"text": {
"full": "The vibe is amazing. We walked in without a reservation and were seated right away even though they were busy. The host was great and services were amazing.\n\nI ordered the chicken and rice and was okay. The rice tasted undercooked and the chicken could have used more seasoning to really bring out its flavor.",
"language": "en"
},
"encid": "iZUQegcOX-GIKLacrlBJ2g",
"author": {
"encid": "P0RUkwZySXJMHmH-njJVkw",
"display_name": "Karla C.",
"friend_count": 1,
"review_count": 9,
"display_location": "Alum Rock, San Jose, CA",
"business_photo_count": 4
},
"rating": 4,
"business": {
"name": "Novela",
"alias": "novela-san-francisco-2",
"encid": "cX5dOMkwZ5rqWbeIJpw_Ig"
},
"feedback": {
"cool_count": null,
"funny_count": null,
"useful_count": null
},
"created_at": null,
"business_photos": [
{
"encid": "OkoVt1WskgotDf6A2NM_gQ",
"caption": null,
"photo_url": "https://s3-media0.fl.yelpcdn.com/bphoto/OkoVt1WskgotDf6A2NM_gQ/348s.jpg",
"helpful_count": null
}
],
"business_videos": [
{
"encid": "txtNP6zT6_BnGSdUnlOBzQ",
"caption": null,
"video_url": "https://stream.mux.com/3F01tjxp00gNsdqVNhaet8gktQvcHRv2ftAUPaH600NuEY/high.mp4",
"__typename": "BusinessVideo",
"time_created": {
"__typename": "DateTime",
"utc_date_time": "2026-04-12T22:07:02Z"
},
"thumbnail_url": "https://image.mux.com/3F01tjxp00gNsdqVNhaet8gktQvcHRv2ftAUPaH600NuEY/thumbnail.jpg?height=720&time=0",
"uploading_user": {
"encid": "P0RUkwZySXJMHmH-njJVkw",
"__typename": "User",
"display_name": "Karla C.",
"profile_photo": {
"encid": "tFsfT564Fo5sv7F-FFowPQ",
"photo_url": {
"url1x": "https://s3-media0.fl.yelpcdn.com/photo/tFsfT564Fo5sv7F-FFowPQ/xss.jpg",
"url2x": "https://s3-media0.fl.yelpcdn.com/photo/tFsfT564Fo5sv7F-FFowPQ/ss.jpg",
"__typename": "UserPhotoUrl"
},
"__typename": "UserProfilePhoto"
},
"is_logged_in_user": null
},
"video_business": {
"name": "Novela",
"alias": "novela-san-francisco-2",
"encid": "cX5dOMkwZ5rqWbeIJpw_Ig",
"location": {
"encid": "cX5dOMkwZ5rqWbeIJpw_Ig",
"address": {
"city": "San Francisco",
"__typename": "BusinessAddress",
"region_code": "CA"
},
"__typename": "BusinessLocation"
},
"__typename": "Business",
"categories": [
{
"encid": "FIW3O50FJ6hyqdvrHxTa0g",
"title": "Cocktail Bars",
"__typename": "BusinessCategory"
},
{
"encid": "1F6C8Q_3pre02ukRakGs3Q",
"title": "Lounges",
"__typename": "BusinessCategory"
},
{
"encid": "9vS4P2Z_kJiWpTLB0O6cYw",
"title": "Venues & Event Spaces",
"__typename": "BusinessCategory"
}
],
"primary_photo": {
"encid": "J8uN_Ux35IHZ0S2q5_2buQ",
"photo_url": {
"url1x": "https://s3-media0.fl.yelpcdn.com/bphoto/J8uN_Ux35IHZ0S2q5_2buQ/xs.jpg",
"url2x": "https://s3-media0.fl.yelpcdn.com/bphoto/J8uN_Ux35IHZ0S2q5_2buQ/s.jpg",
"__typename": "BusinessPhotoUrl"
},
"__typename": "BusinessPhoto"
}
},
"video_publication": {
"__typename": "VideoPublication",
"rendition_set": [
{
"src": "https://stream.mux.com/3F01tjxp00gNsdqVNhaet8gktQvcHRv2ftAUPaH600NuEY/high.mp4",
"duration": 6000,
"__typename": "VideoRendition",
"rendition_id": "progressive_video_high"
},
{
"src": "https://stream.mux.com/3F01tjxp00gNsdqVNhaet8gktQvcHRv2ftAUPaH600NuEY/medium.mp4",
"duration": 6000,
"__typename": "VideoRendition",
"rendition_id": "progressive_video_medium"
},
{
"src": "https://stream.mux.com/3F01tjxp00gNsdqVNhaet8gktQvcHRv2ftAUPaH600NuEY/low.mp4",
"duration": 6000,
"__typename": "VideoRendition",
"rendition_id": "progressive_video_low"
},
{
"src": "https://image.mux.com/3F01tjxp00gNsdqVNhaet8gktQvcHRv2ftAUPaH600NuEY/thumbnail.jpg?height=1080&time=0",
"duration": null,
"__typename": "VideoRendition",
"rendition_id": "poster_high"
},
{
"src": "https://image.mux.com/3F01tjxp00gNsdqVNhaet8gktQvcHRv2ftAUPaH600NuEY/thumbnail.jpg?height=720&time=0",
"duration": null,
"__typename": "VideoRendition",
"rendition_id": "poster_medium"
},
{
"src": "https://image.mux.com/3F01tjxp00gNsdqVNhaet8gktQvcHRv2ftAUPaH600NuEY/thumbnail.jpg?height=480&time=0",
"duration": null,
"__typename": "VideoRendition",
"rendition_id": "poster_low"
},
{
"src": "https://image.mux.com/3F01tjxp00gNsdqVNhaet8gktQvcHRv2ftAUPaH600NuEY/thumbnail.jpg?fit_mode=crop&width=720&height=720",
"duration": null,
"__typename": "VideoRendition",
"rendition_id": "square_thumbnail_720"
},
{
"src": "https://image.mux.com/3F01tjxp00gNsdqVNhaet8gktQvcHRv2ftAUPaH600NuEY/thumbnail.jpg?fit_mode=crop&width=480&height=480",
"duration": null,
"__typename": "VideoRendition",
"rendition_id": "square_thumbnail_480"
}
],
"publication_id": "532b1916-23c9-5469-b16c-d929939797fb"
},
"available_reactions_container": {
"__typename": "AvailableContentReactionsContainer",
"container_format": {
"axis": "HORIZONTAL",
"alignment": "LEADING",
"__typename": "ContentReactionsContainerFormat"
},
"available_reactions": [
{
"count": 0,
"__typename": "AvailableContentReaction",
"show_count": true,
"asset_format": {
"__typename": "ContentReactionAssetFormat",
"text_layout": "OUTSIDE_BUTTON_RIGHT",
"corner_radius": "CIRCULAR",
"disabled_format": {
"__typename": "ContentReactionStateAssetFormat",
"text_color": "coreGrayscaleBlackLight",
"border_color": "coreGrayscaleGrayRegular",
"ripple_color": "coreGrayscaleGrayLightWithAlpha10",
"asset_locator": {
"__typename": "ContentReactionBundledAssetLocator",
"asset_name": "24x24_like_v2"
},
"background_color": "coreGrayscaleWhite"
},
"selected_format": {
"__typename": "ContentReactionStateAssetFormat",
"text_color": "coreGrayscaleBlackRegular",
"border_color": "coreGrayscaleWhite",
"ripple_color": "coreGrayscaleGrayLightWithAlpha50",
"asset_locator": {
"__typename": "ContentReactionBundledAssetLocator",
"asset_name": "24x24_like_filled_v2"
},
"background_color": "coreGrayscaleWhite"
},
"collapsed_format": {
"__typename": "ContentReactionStateAssetFormat",
"text_color": "coreGrayscaleBlackRegular",
"border_color": "coreGrayscaleWhite",
"ripple_color": "coreGrayscaleGrayLightWithAlpha50",
"asset_locator": {
"__typename": "ContentReactionBundledAssetLocator",
"asset_name": "16x16_like_filled_v2"
},
"background_color": "coreGrayscaleWhite"
},
"unselected_format": {
"__typename": "ContentReactionStateAssetFormat",
"text_color": "coreGrayscaleBlackLight",
"border_color": "coreGrayscaleWhite",
"ripple_color": "coreGrayscaleGrayLightWithAlpha50",
"asset_locator": {
"__typename": "ContentReactionBundledAssetLocator",
"asset_name": "24x24_like_v2"
},
"background_color": "coreGrayscaleWhite"
},
"asset_content_type": "IMAGE"
},
"display_text": "likes",
"toggle_state": "UNSELECTED",
"reaction_type": "BIZ_VIDEO_LIKE",
"show_as_tooltip": false,
"show_zero_count": false,
"invert_text_order": true,
"display_text_single_count": "like"
}
],
"is_mutually_exclusive": false
}
}
],
"available_reactions": [
{
"count": 1,
"display_text": "Helpful",
"reaction_type": "HELPFUL"
},
{
"count": 1,
"display_text": "Thanks",
"reaction_type": "THANKS"
},
{
"count": 1,
"display_text": "Love this",
"reaction_type": "LOVE_THIS"
},
{
"count": 0,
"display_text": "Oh no",
"reaction_type": "OH_NO"
}
]
}
],
"pagination": {
"next": 2,
"current": 1,
"other_pages": [],
"total_pages": 155,
"has_next_page": true,
"total_results": 1545
},
"business_id": "cX5dOMkwZ5rqWbeIJpw_Ig"
}{
"error": "Bad Request"
}{
"error": "Invalid API Key"
}{
"error": "Payment required"
}{
"error": "Rate limit exceeded for the API key: quota monthly"
}{
"error": "Internal Error"
}