UnifAPI Docs

List reviews of a Yelp business

Returns public reviews of a Yelp business with rating, text, author, photos and owner replies. Choose recommended, not-recommended or removed reviews with `category`. Paginate with `cursor`.

Pricing — $ · min $0.006

Minimum 6 credits ($0.006) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/yelp/businesses/{id}/reviews

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

id*string

Yelp business alias, as in yelp.com/biz/{id}.

Length1 <= length <= 500

Query Parameters

category?string

Review category to return. Default: recommended.

Value in

  • "recommended"
  • "not_recommended"
  • "removed"
cursor?string

Opaque pagination cursor from a previous response's pagination.next_cursor. Omit for the first page.

Length1 <= length <= 16384

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/yelp/businesses/string/reviews"
{  "request_id": "string",  "data": [    {      "review_id": "string",      "user_id": "string",      "name": "string",      "link": "string",      "thumbnail": "string",      "address": "string",      "friends": 0,      "reviews": 0,      "photos": 0,      "elite_year": "string",      "rating": 0,      "date": "string",      "text": "string",      "language": "string",      "is_updated": true,      "previous_versions": [        {          "date": "string",          "rating": 0,          "text": "string"        }      ],      "reactions": {        "helpful": 0,        "thanks": 0,        "love_this": 0,        "oh_no": 0      },      "review_photos": [        {          "link": "string",          "caption": "string"        }      ],      "owner_replies": [        {          "comment": "string",          "date": "string",          "owner": {            "name": "string",            "role": "string"          }        }      ],      "reason": "string"    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}