# 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?