# Trip.com Attractions Search API Documentation

<p><strong>Trip.com Attractions Search API Documentation</strong> Search attractions, tours and tickets by destination or name. Each result has an id, name, city, rating, review count, ranking, price, original price, discount, tags and an image. Results of type attraction work with the detail and reviews endpoints; type tour is a bookable product and has no detail page here. Page N is really page N, 12 per page. total_estimate is a loose keyword count, not an exact total. has_more is true when the page is full. Sorts price_asc and price_desc are ordered by price. No category filter exists: a category parameter returns 422. An empty page returns 200 and costs nothing. Cost: 1 credit.</p>

- **Documentation:** [https://scrappa.co/docs/tripcom-api/tripcom_attractions_search](https://scrappa.co/docs/tripcom-api/tripcom_attractions_search)
- **API group:** Trip.com API
- **Endpoint:** `GET https://scrappa.co/api/tripcom/attractions/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Destination or attraction name, 2 to 100 characters. Example: paris. |
| `page` | integer | No | Page number, 1 to 100. Each page has 12 results. Defaults to 1. |
| `sort` | string | No | recommended, price_asc or price_desc. Defaults to recommended. |
| `currency` | string | No | USD, EUR, GBP, JPY or KRW. Defaults to USD. Every price in the answer uses this currency. |
| `locale` | string | No | Site language: en, en-gb, de, fr, ja, ko or zh-hk. Defaults to en. It sets the language of names and tags. Text on detail pages stays English. |

## Example response

```json
{
    "data": {
        "page": 1,
        "sort": "recommended",
        "count": 12,
        "items": [
            {
                "id": "78772",
                "city": "Paris",
                "name": "Eiffel Tower",
                "tags": [
                    {
                        "tags": [
                            "Historic landmark"
                        ],
                        "group": "CATEGORY_THEME_TAG"
                    }
                ],
                "type": "attraction",
                "price": 23.41,
                "poi_id": "78772",
                "rating": 4.6,
                "is_free": false,
                "ranking": {
                    "rank": 21,
                    "description": "2026 Global 100 - Best Things to Do"
                },
                "currency": "USD",
                "highlight": null,
                "image_url": "https://ak-d.tripcdn.com/images/example.jpg",
                "detail_url": "https://www.trip.com/travel-guide/attraction/paris/eiffel-tower-78772?curr=USD&locale=en-XX&poiType=3",
                "review_count": 4363,
                "discount_label": null,
                "original_price": null,
                "discount_amount": null,
                "detail_supported": true
            }
        ],
        "query": "paris",
        "locale": "en",
        "currency": "USD",
        "has_more": true,
        "page_size": 12,
        "total_estimate": 112368
    },
    "meta": {
        "billable": true,
        "endpoint_family": "attractions_search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 503 | Unexpected Upstream Format | Trip.com answered with a format Scrappa does not know. This response is not billable. |
| 503 | Upstream Unavailable | Trip.com did not answer after one retry. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)