# TripAdvisor Restaurants API (https://www.socialcrawl.dev/platforms/tripadvisor/restaurants)

> Searches TripAdvisor restaurants in a destination, with filters for cuisine, meal type, price level, dietary restriction, open-now, and online reservations. Returns a unified PlaceList carrying the star rating, review count, cuisine tags, a photo, and the `url_path` you pass to /v1/tripadvisor/restaurant or /v1/tripadvisor/restaurant/reviews.

TL;DR: `GET /v1/tripadvisor/restaurants` 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 |
| --- | --- | --- |
| `q` | yes | City, region, or destination, e.g. 'Paris'. |
| `depth` | no | Number of restaurants to retrieve (default 30, max 100). |
| `cuisine` | no | Cuisine filter: any \| local \| italian \| french \| indian \| chinese \| japanese \| mexican \| seafood \| steakhouse \| cafe \| fast_food. (any \| local \| italian \| french \| indian \| chinese \| japanese \| mexican \| seafood \| steakhouse \| cafe \| fast_food) |
| `meal_type` | no | Meal filter: any \| breakfast \| lunch \| dinner \| brunch. (any \| breakfast \| lunch \| dinner \| brunch) |
| `price_level` | no | Price band: any \| cheap \| moderate \| expensive \| fine_dining. (any \| cheap \| moderate \| expensive \| fine_dining) |
| `dietary_restriction` | no | Dietary filter: any \| vegetarian \| vegan \| gluten_free \| halal \| kosher. (any \| vegetarian \| vegan \| gluten_free \| halal \| kosher) |
| `open_now` | no | Only return restaurants currently marked open. |
| `online_reservations` | no | Only return restaurants that accept online reservations. |
| `language` | no | Optional locale, e.g. 'en-US'. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/tripadvisor/restaurants" \
  --data-urlencode "q=Paris" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the TripAdvisor Restaurants API return?

Returns TripAdvisor restaurants in a destination with star rating, review count, and cuisine tags, filtered by cuisine, meal, price, or dietary need. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the TripAdvisor Restaurants endpoint?

Use it to shortlist places to eat in a city, then chain restaurant or restaurant/reviews.

### How much does the TripAdvisor Restaurants API cost?

Each call costs 1 credit, so the 100 free credits every new account gets cover 100 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the TripAdvisor Restaurants API need?

The one required parameter is q (city, region, or destination, e.g). It also accepts 8 optional parameters, all listed on this page.

### How do I call the TripAdvisor Restaurants API?

Send a GET request to https://www.socialcrawl.dev/v1/tripadvisor/restaurants?q=Paris with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full TripAdvisor API: https://www.socialcrawl.dev/platforms/tripadvisor

## 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 does the SocialCrawl TripAdvisor Restaurants API return?
- How do I get TripAdvisor Restaurants data with the SocialCrawl API?