Piloterr

Yelp Reviews

GET
/v2/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

Autorização

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Parâmetros de consulta

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"

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.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"}