Search for attractions 3.2 Beta

Learn how to use the /attractions/search endpoint to find and retrieve attractions that match travellers’ preferences, locations, and travel dates.

→ Use the /attractions/search endpoint to retrieve a list of available attractions, activities, and experiences based on a search criterion, travel dates, and optional filters.

This endpoint returns real-time availability and up-to-date prices for our travel experiences inventory.

The smallest valid request must include:

• A location search criterion
• Currency
• Dates

Example:

{
  "currency": "EUR",
  "cities": [-2140479, -2154955],
  "dates": {
    "start_date": "2026-09-18",
    "end_date": "2026-09-20"
  }
}

Optional parameters such as filters, rows, and sort

A search request defines the parameters used to find attractions. The response returns a list of matching attractions and metadata describing the result set.

Example scenario:

Retrieve attractions in the Netherlands and Belgium available between 18–20 September 2026, filtered by minimum review score and supported languages.

{
  "currency": "EUR",
  "countries": ["nl", "be"],
  "dates": {
    "start_date": "2026-09-18",
    "end_date": "2026-09-20"
  },
  "filters": {
    "rating": {
      "minimum_review_score": 4.2,
      "minimum_review_count": 100
    },
    "supported_languages": ["en", "es", "fr", "de"]
  },
  "rows": 50,
  "sort": {
    "by": "most_popular"
  }
}

The request body defines where and how to search for attractions.

You must include one of the following fields to define where to search for attractions.

Example (city search):

{
  "currency": "EUR",
  "cities": [-2140479],
  "dates": {
    "start_date": "2026-09-18",
    "end_date": "2026-09-20"
  }
}

Filters allow you to restrict the search to specific criteria. You can use one or more filters in the same request.

• filters.categories – Filter by attraction type
• filters.rating – Filter by review score and count
• filters.supported_languages – Filter by supported languages

Use filters.categories to filter results by type of attraction.

Example of filter by categories request:

{
  "currency": "EUR",
  "countries": ["nl"],
  "dates": {
    "start_date": "2026-06-18",
    "end_date": "2026-06-20"
  },
  "filters": {
    "categories": ["PTTV32SGqJEv"]
  }
}

Supported categories include:

• You can provide multiple category IDs. Results include attractions that match any of the selected categories.

You can filter by review score and total count.

Use filters.supported_languages to filter results by the languages supported by the attraction (IETF language tags).

"filters": {
  "supported_languages": ["en", "de"]
}

Filters allow you to refine results based on quality indicators and traveller preferences.

"filters": {
  "categories": ["PTTV32SGqJEv"]
  "rating": {
    "minimum_review_score": 4.0,
    "minimum_review_count": 50
  },
  "supported_languages": ["en", "de"]
}

• Use rows to set the number of results returned per page.
• Use page as pagination token returned in metadata.next_page.
• Use sort.by to control how attractions results are ordered.

Pagination and sorting example

"rows": 50,
"sort": {
  "by": "lowest_price_first"
},
"page": "eyJhbGciOiJIUzI1NiJ9..."

The response returns:

• Matching attractions.
• Pagination metadata.
• A unique request identifier.

{
  "data": [
    {
      "id": "PRahAzWtTraa",
      "free_cancellation": true,
      "price": {
        "currency": "EUR",
        "total": 20
      },
      "urls": {
        "app": {
          "detail": "booking://attractions/product?slug=prahazwttraa-heineken-experience-amsterdam&aid=956509",
          "search_results": "booking://attractions/searchresults?ufi=-2140479&pinned_product_id=PRahAzWtTraa&aid=956509"
        },
        "web": {
          "detail": "https://www.booking.com/attractions/nl/prahazwttraa-heineken-experience-amsterdam.en-gb.html?selected_currency=EUR&aid=956509",
          "search_results": "https://www.booking.com/attractions/searchresults/nl/amsterdam.en-gb.html?pinned_product=PRahAzWtTraa&aid=956509"
        }
      }
    },
    {
      "id": "PRAmdacCwQLH",
      "free_cancellation": false,
      "price": {
        "currency": "EUR",
        "total": 15.5
      },
      "urls": {
        "app": {
          "detail": "booking://attractions/product?slug=pramdaccwqlh-madame-tussauds-ticket&aid=956509",
          "search_results": "booking://attractions/searchresults?ufi=-2140479&pinned_product_id=PRAmdacCwQLH&aid=956509"
        },
        "web": {
          "detail": "https://www.booking.com/attractions/nl/pramdaccwqlh-madame-tussauds-ticket.en-gb.html?selected_currency=EUR&aid=956509",
          "search_results": "https://www.booking.com/attractions/searchresults/nl/amsterdam.en-gb.html?pinned_product=PRAmdacCwQLH&aid=956509"
        }
      }
    }
  ],
  "metadata": {
    "next_page": "eyJhbGciOiJIUzI1NiJ9...",
    "total_results": 128
  },
  "request_id": "01fr9ez700exycb98w90w5r9sh"
}

If no attractions are returned:

• Verify that the date range has available inventory.
• Check whether filters are too restrictive.
• Confirm that city or country IDs are valid.

Most integrations use /attractions/search as part of the following workflow:

1. Retrieve location identifiers from /common/locations endpoints.
2. Search for attractions using /attractions/search.
3. Display results to travellers.
4. Retrieve full product information with /attractions/details.
5. Continue with availability and booking flows.

✅ Optimise performance:

• Limit rows to 20–50 results for faster responses.
• Use pagination tokens instead of fetching all data at once.

✅ Improve result relevance:

• Combine location-based search (coordinates) and qualitative filters.
• Select sort.by according to the traveller’s goal, such as most_popular for discovery or lowest_price_first for value.

✅ Maintain integration efficiency

• Always include currency and travel dates.
• Store location IDs from /common/locations endpoints and previously retrieved attraction lists to minimise repeated lookups and API calls.