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

> Returns Yelp typeahead rows for a query in a location: category, common, chain, and business suggestions, each with a title, type, and optional subtitle, thumbnail, and redirect URL. Business rows carry alias URLs, which do not resolve on GET /v1/yelp/business/info. Category redirect URLs may be incomplete.

TL;DR: `GET /v1/yelp/search/suggestions` 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. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/yelp/search/suggestions?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