UnifAPI Docs

Search Yelp businesses

Searches Yelp for businesses by name, service or category near a location, sorted by Yelp's recommendation, rating or review count. Paginate with `cursor`.

Pricing — $ · min $0.003

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

GET
/yelp/businesses/search

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

query*string

Business name, service, or category to search for.

Length1 <= length <= 200
location*string

City, neighbourhood, postcode or address to search near.

Length1 <= length <= 200
sort?string

Result order. recommended is Yelp's default ranking. highest_rated and most_reviewed use Yelp's own sorts.

Value in

  • "recommended"
  • "highest_rated"
  • "most_reviewed"
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/search?query=string&location=string"
{  "request_id": "string",  "data": [    {      "alias": "string",      "name": "string",      "url": "string",      "ranking": 0,      "rating": 0,      "review_count": 0,      "price_range": "string",      "phone": "string",      "categories": [        {          "alias": "string",          "title": "string"        }      ],      "address": {        "line1": "string",        "line2": "string",        "city": "string",        "region": "string",        "postal_code": "string",        "country": "string",        "formatted": "string"      },      "coordinates": {        "latitude": 0,        "longitude": 0      },      "photo_url": "string",      "is_closed": true    }  ],  "pagination": {    "has_more": true,    "next_cursor": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}