# TripAdvisor Attractions API (https://www.socialcrawl.dev/platforms/tripadvisor/attractions)

> Searches TripAdvisor attractions, tours, museums, and activities in a destination, with filters for category, duration, minimum traveler rating, free cancellation, skip-the-line, and private tours. Returns a unified PlaceList carrying the star rating, review count, a photo, and the `url_path` you pass to /v1/tripadvisor/attraction or /v1/tripadvisor/attraction/reviews.

TL;DR: `GET /v1/tripadvisor/attractions` 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. 'Bangkok'. |
| `depth` | no | Number of attractions to retrieve (default 30, max 100). |
| `category` | no | Category: any \| attractions \| tours \| outdoor_activities \| museums \| shopping \| nightlife \| spas \| classes_workshops. (any \| attractions \| tours \| outdoor_activities \| museums \| shopping \| nightlife \| spas \| classes_workshops) |
| `duration` | no | Activity duration: any \| lt_1_hour \| 1_to_4_hours \| 4_hours_to_1_day \| multi_day. (any \| lt_1_hour \| 1_to_4_hours \| 4_hours_to_1_day \| multi_day) |
| `traveler_rating` | no | Minimum traveler rating: any \| 3 \| 3.5 \| 4 \| 4.5 \| 5. (any \| 3 \| 3.5 \| 4 \| 4.5 \| 5) |
| `free_cancellation` | no | Only return activities with free cancellation. |
| `skip_the_line` | no | Only return skip-the-line activities. |
| `private_tour` | no | Only return private tours. |
| `currency` | no | Optional 3-letter currency code, e.g. 'USD'. |

## Code example

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

## FAQ

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

Call GET /v1/tripadvisor/attractions with q set to a city, region or destination, for example Bangkok. It returns attractions, tours, museums and activities as a unified PlaceList, ready to sort by rating or review count.

### What does the TripAdvisor attractions endpoint return for each place?

Each result carries the name, category, star rating, review count, a photo and the url_path that identifies the place. Pass that to GET /v1/tripadvisor/attraction for details or /v1/tripadvisor/attraction/reviews for traveler reviews.

### Which filters does the TripAdvisor attractions API support?

It supports category (attractions, tours, outdoor_activities, museums, shopping, nightlife, spas, classes_workshops), duration, a minimum traveler_rating and the booleans free_cancellation, skip_the_line and private_tour. A currency code is optional.

### How many attractions can one call return?

depth sets how many attractions to retrieve, with a default of 30 and a maximum of 100. The call is a single request, so the whole depth comes back in one response rather than across pages.

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

Each call costs 1 credit on the standard tier, whatever the depth. Credits for failed or empty calls are refunded automatically, and there is no subscription. 100 free credits cover 100 searches.

### Do I need a TripAdvisor Content API key for attractions?

No. You use one SocialCrawl API key, so there is no TripAdvisor partner application. Attractions use the same PlaceList schema as the restaurant and hotel searches, which makes destination comparisons straightforward.

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 do I get TripAdvisor things to do with the SocialCrawl API?
- Which API searches TripAdvisor attractions, tours and museums by destination?
- What filters does the SocialCrawl TripAdvisor attractions endpoint support?