# Yelp Data API (https://www.socialcrawl.dev/platforms/yelp)

> Yelp API with 5 endpoints: look up a business by its encid, page through reviews with owner replies, and search businesses by term and location. Business info costs 1 credit, and a new account gets 100 free credits with no card.

TL;DR: SocialCrawl's Yelp API exposes 5 endpoints, 1 to 9 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Business Info | GET | `/v1/yelp/business/info` | 1 | Get a Yelp business by encid |
| Business Reviews | GET | `/v1/yelp/business/reviews` | 5 to 9 | Get Yelp reviews for a business |
| Search | GET | `/v1/yelp/search` | 1 | Search Yelp businesses |
| Search Full | GET | `/v1/yelp/search/full` | 1 | Search Yelp businesses with full cards |
| Search Suggestions | GET | `/v1/yelp/search/suggestions` | 1 | Get Yelp search suggestions |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/yelp/business/info" \
  --data-urlencode "id=zj8Lq1T8KIC5zwFief15jg" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### Which Yelp endpoints does SocialCrawl offer?

There are 5 endpoints: business info, business reviews, search, search/full (the same search with the same fields on every business) and search suggestions. Businesses, reviews and search results come back as unified Place, ReviewList and PlaceList JSON, shared with the other 68 platforms.

### How do I find the ID of a Yelp business?

Call GET /v1/yelp/search with a term and a location, for example Pizza in New York, NY. Each business carries its 22-character encid as place.id, and you pass that id to the business info and reviews endpoints.

### Why does a Yelp alias URL return not found?

The business endpoints accept the 22-character encid, not alias slugs like prince-street-pizza-new-york-2. An alias or alias URL returns not found, and the call is refunded automatically. Use search to turn a name into an encid.

### Can I sort Yelp search results by rating?

No. Search results are served in Yelp's recommended order, and sort=rating or sort=review_count is refused with a free 400. To rank by rating or review count, sort the returned items by place.rating.value or place.reviews_count yourself.

### How do Yelp reviews paginate?

GET /v1/yelp/business/reviews returns 10 reviews a page with a cursor for the next page. Each review carries an ISO timestamp, owner reply, photo URLs, language and HELPFUL vote counts, and page 2 does not overlap page 1.

### What happens when a Yelp business has no results?

A location Yelp does not cover returns an empty list, and a business with no reviews returns an empty page. Neither is billed, and a business that does not exist returns a 404 that is refunded automatically.

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What is the SocialCrawl Yelp API?
- How do I get Yelp reviews with an API?
- Which API returns Yelp business ratings and review counts?