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

> Searches Yelp businesses by term and location. Returns a unified PlaceList: name, rating, review count, price level, address, coordinates, categories, and photos when the provider returns rows. Sort by recommended, rating, or review_count. ads=true includes sponsored results. Page with cursor from next_cursor. If the provider reports a non-zero total with no rows, the call fails and is refunded. Search cards may carry an alias URL; only the 22-character encid resolves on GET /v1/yelp/business/info.

TL;DR: `GET /v1/yelp/search` 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 |
| --- | --- | --- |
| `query` | yes | Search term as typed on Yelp, for example Pizza or coffee. |
| `location` | yes | City or full location string, for example New York, NY or San Francisco, CA, United States. Required with query. |
| `cursor` | no | Cursor from the previous page's next_cursor. Omit on page 1. Live pages use a numeric offset such as 10. |
| `sort` | no | Result order. recommended (default), rating, or review_count. (recommended \| rating \| review_count) |
| `ads` | no | When true, include sponsored results. Default false. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/yelp/search?query=Pizza&location=New%20York%2C%20NY" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

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