# TripAdvisor Search API (https://www.socialcrawl.dev/platforms/tripadvisor/search)

> Searches TripAdvisor for businesses and places (restaurants, hotels, attractions) matching a keyword in a location. Returns a unified PlaceList — each result carries the place name, category, star rating, total review count, and the `url_path` (the `id`/`url` are derived from it) that you pass to /v1/tripadvisor/reviews to pull that place's reviews. Results are location-bound (default: United States). Sourced from DataForSEO's task-based Business Data API; the async lifecycle is handled server-side, so this is an ordinary synchronous request (first calls take ~15-45s, then serve from cache).

TL;DR: `GET /v1/tripadvisor/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 |
| --- | --- | --- |
| `q` | yes | Business category, company name, or prominent place (e.g. 'pizza restaurant'). |
| `location` | no | Full location name (e.g. 'New York,New York,United States'). Default: United States. Results are location-bound. |
| `language` | no | Optional language code to narrow results, e.g. 'en'. |
| `depth` | no | Number of results to retrieve (multiples of 30, default 30, max 60 on this synchronous endpoint). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/tripadvisor/search?q=pizza%20restaurant" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I search TripAdvisor places with an API?

Send a GET request to /v1/tripadvisor/search with a q parameter, a business category, company name, or place like 'pizza restaurant'. SocialCrawl returns a unified PlaceList with each place's name, category, star rating, review count, and url_path.

### What does the TripAdvisor Search API return?

Each result carries the place name, category, star rating, total review count, and the url_path that identifies the place on TripAdvisor. The url_path is the key you pass to /v1/tripadvisor/reviews to pull that place's traveler reviews.

### Can I limit TripAdvisor search results to a city?

Yes. Pass the location parameter as a full location name such as 'New York,New York,United States'. Results are location-bound, and the default location is United States. An optional language code narrows results further.

### How many results can one TripAdvisor search return?

The depth parameter controls result count in multiples of 30. The default is 30 and the maximum is 60 on this synchronous endpoint. Each request costs 1 credit regardless of depth.

### Why is the first TripAdvisor search slower than the next ones?

The upstream source is task-based, so a first-time query takes roughly 15–45 seconds while data is gathered. SocialCrawl handles the async lifecycle server-side: you make a normal GET request, and repeat queries return quickly from cache.

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:

- How to search TripAdvisor hotels and restaurants with an API
- What does the SocialCrawl TripAdvisor Search API return?