# Yelp Business Info API (https://www.socialcrawl.dev/platforms/yelp/business-info)

> Returns a unified Place for one Yelp business: name, alias URL, unrounded star rating on a 5-star scale, exact review count, price level, address, coordinates, categories, photos, and timezone. Identify the business by its 22-character Yelp encid (`id`). A Yelp URL works only when the /biz/ segment is that encid; alias slugs return 404 (auto-refunded). Phone is not present on the upstream payload. To find an encid, start from GET /v1/yelp/search.

TL;DR: `GET /v1/yelp/business/info` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | Yelp business encid, the 22-character opaque id (for example zj8Lq1T8KIC5zwFief15jg for Prince Street Pizza). Alias slugs such as prince-street-pizza-new-york-2 are not accepted on this surface: they come back as not found. |
| `url` | no | Yelp business URL. Only URLs whose /biz/ segment is the 22-character encid resolve. Alias URLs such as https://www.yelp.com/biz/prince-street-pizza-new-york-2 come back as not found. |

## 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"
```

## FAQ

### How do I get Yelp business data with an API?

Call GET /v1/yelp/business/info with id, the 22-character Yelp business encid, for example zj8Lq1T8KIC5zwFief15jg. It returns one business as a unified Place, and you can find the encid first with GET /v1/yelp/search.

### What does the Yelp business info endpoint return?

It returns the name, Yelp URL, unrounded star rating on a 5-star scale, exact review count, price level, address, coordinates, categories, photos and timezone. A phone number is not part of the response.

### Can I look up a Yelp business by its URL or alias?

Yes, but only when the /biz/ segment of the URL is the 22-character encid. Alias slugs such as prince-street-pizza-new-york-2 come back as not found, and that call is refunded automatically. Search the business by name and location to get its encid.

### How much does the Yelp API cost?

A business lookup costs 1 credit on the standard tier. Credits for failed or empty calls are refunded automatically, and there is no subscription. The 100 free credits on a new account cover 100 lookups.

### Do I need a Yelp API key to use this?

No. You call SocialCrawl with one SocialCrawl API key, and the Yelp data is sourced for you. The business comes back in the same Place schema that TripAdvisor places use, which keeps multi-platform local data comparable.

### Can I get Yelp reviews and search results too?

Yes. GET /v1/yelp/business/reviews returns 10 reviews a page with owner replies and cursor pagination, and GET /v1/yelp/search returns 10 businesses a page for a term and location. Search results use Yelp's recommended order, and sorting by rating or review count is refused.

See the full Yelp API: https://www.socialcrawl.dev/platforms/yelp

## 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 best Yelp API alternative for business data?
- How do I get Yelp business details with the SocialCrawl API?
- Does SocialCrawl have a Yelp API for ratings and review counts?