# Yelp API — UnifAPI

> Business search, details, reviews, photos. Search Yelp businesses by keyword and location, then read business details, hours, amenities, full reviews with ratings, and photos.

- Category: Local & Maps
- API base URL: https://api.unifapi.com
- Auth: `Authorization: Bearer <UnifAPI API key>` (OAuth recommended for MCP clients)
- MCP server: https://mcp.unifapi.com
- Developer docs: https://docs.unifapi.com/api/yelp
- OpenAPI spec: https://unifapi.com/openapi.json
- HTML page: https://unifapi.com/apis/yelp
- Full catalog: https://unifapi.com/apis.md

## Agent workflows

- Find and rank local businesses by rating, review count, price range and category for lead or market research.
- Summarize what customers praise and criticize from a business's full Yelp reviews and owner replies.
- Compare competitors' hours, amenities and photos in one local market.

## Endpoints (4)

Every endpoint returns the UnifAPI JSON envelope (`request_id`, `data`, `pagination` on lists, `billing`) and bills max(records × credits per record, minimum) in credits.

### Get a Yelp business

`GET /yelp/businesses/{id}`

Returns a Yelp business by alias: rating, review count, price range, phone, website, address, coordinates, categories, opening hours and amenities. Returns `not_found` when the business does not exist.

- Price: 1 credit per record, minimum 6 credits ($0.006) per call
- Required: `id` (path)
- Details: https://unifapi.com/apis/yelp/businesses/id/get
- Docs: https://docs.unifapi.com/api/yelp/businesses/id/get

### List photos of a Yelp business

`GET /yelp/businesses/{id}/photos`

Returns public photos of a Yelp business with captions and URLs. Paginate with `cursor`.

- Price: 1 credit per record, minimum 6 credits ($0.006) per call
- Required: `id` (path)
- Details: https://unifapi.com/apis/yelp/businesses/id/photos/get
- Docs: https://docs.unifapi.com/api/yelp/businesses/id/photos/get

### List reviews of a Yelp business

`GET /yelp/businesses/{id}/reviews`

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`.

- Price: 1 credit per record, minimum 6 credits ($0.006) per call
- Required: `id` (path)
- Details: https://unifapi.com/apis/yelp/businesses/id/reviews/get
- Docs: https://docs.unifapi.com/api/yelp/businesses/id/reviews/get

### Search Yelp businesses

`GET /yelp/businesses/search`

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

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `query` (query), `location` (query)
- Details: https://unifapi.com/apis/yelp/businesses/search/get
- Docs: https://docs.unifapi.com/api/yelp/businesses/search/get

## Related APIs

- [Maps API](https://unifapi.com/apis/maps/index.md) — Local business listings, ratings, places
- [Local Finder API](https://unifapi.com/apis/local/index.md) — Expanded local-pack places
- [Hotels API](https://unifapi.com/apis/hotels/index.md) — Hotel search, prices, reviews, details
- [Events API](https://unifapi.com/apis/events/index.md) — Concerts, festivals, local happenings