Logo SearchApi

Tripadvisor API Documentation

GET   /api/v1/search?engine=tripadvisor
OpenAPI Initiative Download OpenAPI Spec

The Tripadvisor API gives access to hotels, restaurants, attractions, and destinations worldwide. Search for places and forum discussions across all Tripadvisor domains.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    Parameter defines the query you want to search. This can be a destination, hotel name, restaurant, attraction, or any travel-related search term.

Localization

Filters

  • Name
    category
    Required
    Optional
    Description

    This parameter filters results by category.

    Main options are places and forums. Default value is places.
    You can also filter by place category using: things_to_do, restaurants, destinations, hotels, airlines.

Geographic Location

  • Name
    location
    Required
    Optional
    Description

    Parameter defines the location for the search. The location is resolved to GPS coordinates using the locations API. See the full list of supported locations.

  • Name
    lat
    Required
    Optional
    Description

    Parameter defines the GPS latitude for the search origin. Must be between -90 and 90. Must be used together with lon.

  • Name
    lon
    Required
    Optional
    Description

    Parameter defines the GPS longitude for the search origin. Must be between -180 and 180. Must be used together with lat.

Pagination

  • Name
    num
    Required
    Optional
    Description

    This parameter defines the number of results to return per page. Acceptable values are between 1 and 100.

  • Name
    page
    Required
    Optional
    Description

    This parameter defines the page number for pagination. Must be 1 or greater.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to tripadvisor.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Search for Places

Search for Places
GET
https://www.searchapi.io/api/v1/search?engine=tripadvisor&q=Barcelona
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tripadvisor",
  "q": "Barcelona"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_abc123def456ghi789",
    "status": "Success",
    "created_at": "2026-01-15T14:30:00Z",
    "request_time_taken": 1.2,
    "parsing_time_taken": 0.1,
    "total_time_taken": 1.3,
    "request_url": "https://www.tripadvisor.com/Search?q=Paris",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_abc123def456ghi789.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_abc123def456ghi789"
  },
  "search_parameters": {
    "engine": "tripadvisor",
    "tripadvisor_domain": "tripadvisor.com",
    "q": "Barcelona",
    "category": "all",
    "page": 1
  },
  "search_information": {
    "total_results": 2000
  },
  "place_results": [
    {
      "position": 1,
      "place_id": 187497,
      "title": "Barcelona",
      "type": "Destination",
      "link": "https://www.tripadvisor.com/Tourism-g187497-Barcelona_Catalonia-Vacations.html",
      "description": "Barcelona feels a bit surreal – appropriate, since Salvador Dali spent time here and Spanish Catalan architect Antoni Gaudí designed several of the city’s buildings. Stepping into Gaudí’s Church of the Sacred Family is a bit like falling through the looking glass - a journey that you can continue with a visit to Park Güell. Sip sangria at a sidewalk café in Las Ramblas while watching flamboyant street performers, then create your own moveable feast by floating from tapas bar to tapas bar.",
      "location": "Catalonia, Spain",
      "thumbnail": {
        "link": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/04/24/20/3a/barcelona.jpg",
        "width": 800,
        "height": 451
      }
    },
    {
      "position": 2,
      "place_id": 11988199,
      "title": "Barcelona in 1 Day: Sagrada Familia, Park Guell,Old Town & Pickup",
      "type": "Attraction",
      "link": "https://www.tripadvisor.com/AttractionProductReview-g187497-d11988199-Barcelona_in_1_Day_Sagrada_Familia_Park_Guell_Old_Town_Pickup-Barcelona_Catalonia.html",
      "description": "Have only limited time in Barcelona? See the best of the city in a single day on this comprehensive tour. With round-trip transit directly from your hotel, see and do more than you could alone. Tour the Passeig de Gracia, glimpse Las Ramblas, admire views from Montjuïc, and explore the Old Town on foot. Then, discover two of architect Antoni Gaudí's top landmarks when you visit Park Güell and La Sagrada Familia (separate expense).",
      "rating": 4.9,
      "reviews": 10413,
      "mentions": 6088,
      "review_snippet": "Vicente shared so many fascinating tidbits about Barcelona!",
      "review_snippet_highlighted_words": [
        "Barcelona"
      ],
      "location": "Barcelona, Catalonia, Spain",
      "thumbnail": {
        "link": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/30/03/11/f9/caption.jpg",
        "width": 720,
        "height": 480
      }
    },
      ...
  ],
  "pagination": {
    "current": 1,
    "next": 2,
    "total_pages": 67
  }
}

Search by Location

Search by Location
GET
https://www.searchapi.io/api/v1/search?engine=tripadvisor&location=Rio+de+Janeiro&q=Restaurants
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tripadvisor",
  "q": "Restaurants",
  "location": "Rio de Janeiro"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_abc123def456ghi789",
    "status": "Success",
    "created_at": "2026-01-15T14:30:00Z",
    "request_time_taken": 1.38,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.39,
    "request_url": "https://www.tripadvisor.com/Search?q=Restaurants&ssrc=a&geo=1&offset=0&limit=30",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_abc123def456ghi789.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_abc123def456ghi789"
  },
  "search_parameters": {
    "engine": "tripadvisor",
    "tripadvisor_domain": "tripadvisor.com",
    "q": "Restaurants",
    "category": "all",
    "location": "Rio de Janeiro",
    "location_used": "State of Rio de Janeiro,Brazil",
    "page": 1
  },
  "search_information": {
    "total_results": 2000
  },
  "place_results": [
    {
      "position": 1,
      "place_id": 983060,
      "title": "Restaurante Marius Degustare",
      "type": "Restaurant",
      "link": "https://www.tripadvisor.com/Restaurant_Review-g303506-d983060-Reviews-Restaurante_Marius_Degustare-Rio_de_Janeiro_State_of_Rio_de_Janeiro.html",
      "description": "Tasting Menu - A unique selection of special meats, fish, and seafood served at the table, a buffet of hot and cold dishes from Brazilian and Mediterranean cuisine, and a variety of organic salads.",
      "rating": 4.8,
      "reviews": 19370,
      "mentions": 1070,
      "review_snippet": "This restaurant has it all.",
      "review_snippet_highlighted_words": [
        "restaurant"
      ],
      "location": "Rio de Janeiro, State of Rio de Janeiro, Brazil",
      "thumbnail": {
        "link": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/31/34/9d/9e/buffet-de-pratos-quentes.jpg",
        "width": 2000,
        "height": 2000
      }
    },
    ...
  ],
  "pagination": {
    "current": 1,
    "next": 2,
    "total_pages": 67
  }
}

Search for Forums

Search for Forums
GET
https://www.searchapi.io/api/v1/search?category=forums&engine=tripadvisor&q=Bali
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tripadvisor",
  "q": "Bali",
  "category": "forums"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_xyz789abc123def456",
    "status": "Success",
    "created_at": "2026-01-15T14:35:00Z",
    "request_time_taken": 1.53,
    "parsing_time_taken": 0.02,
    "total_time_taken": 1.55,
    "request_url": "https://www.tripadvisor.com/Search?q=Bali&ssrc=f&geo=1&offset=0&limit=30",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_xyz789abc123def456.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_xyz789abc123def456"
  },
  "search_parameters": {
    "engine": "tripadvisor",
    "tripadvisor_domain": "tripadvisor.com",
    "q": "Bali",
    "category": "forums",
    "page": 1
  },
  "search_information": {
    "total_results": 2000
  },
  "forum_results": [
    {
      "position": 1,
      "forum_id": 15376863,
      "title": "Bali",
      "link": "https://www.tripadvisor.com/ShowTopic-g294226-i7220-k15376863-Bali-Bali.html#123942226",
      "snippet": "Hi Have a half day in Bali in the midst of meeting, what places can",
      "snippet_highlighted_words": [
        "i in"
      ],
      "author": {
        "username": "surabhig2022",
        "link": "https://www.tripadvisor.com/Profile/surabhig2022"
      },
      "iso_date": "2025-06-23",
      "location": "Indonesia"
    },
    ...
  ],
  "pagination": {
    "current": 1,
    "next": 2,
    "total_pages": 67
  }
}

Search for Airlines

Search for Airlines
GET
https://www.searchapi.io/api/v1/search?category=airlines&engine=tripadvisor&q=Air+France
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "tripadvisor",
  "q": "Air France",
  "category": "airlines"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_xyz789abc123def456",
    "status": "Success",
    "created_at": "2026-01-15T14:35:00Z",
    "request_time_taken": 1.53,
    "parsing_time_taken": 0.02,
    "total_time_taken": 1.55,
    "request_url": "https://www.tripadvisor.com/Search?q=Bali&ssrc=f&geo=1&offset=0&limit=30",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_xyz789abc123def456.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_xyz789abc123def456"
  },
  "search_parameters": {
    "engine": "tripadvisor",
    "tripadvisor_domain": "tripadvisor.com",
    "q": "air france",
    "category": "airlines",
    "page": 1
  },
  "search_information": {
    "total_results": 184
  },
  "place_results": [
    {
      "position": 1,
      "place_id": 8729003,
      "title": "Air France",
      "type": "Airline",
      "link": "https://www.tripadvisor.com/Airline_Review-d8729003-Reviews-Air-France",
      "description": "Air France (AF) is the French flag carrier and the country's largest airline. A founding member of the SkyTeam alliance, Air France flies to about 35 destinations within France and about 170 destinations in 93 other countries. Non-stop flights are available to points across Europe, Asia, Africa, North America and South America. International long-haul flights typically feature three or four classes of service. For short- and medium-haul flights within Europe, the airline uses a three-cabin configuration. AF has hubs at Paris's Charles de Gaulle Airport (CDG) and Orly Airport (ORY).",
      "rating": 3,
      "reviews": 37926,
      "mentions": 6975,
      "review_snippet": ", and Air France truly stood out.",
      "review_snippet_highlighted_words": [
        "Air",
        "France"
      ],
      "thumbnail": {
        "link": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/0e/cd/51/58/air-france.jpg",
        "width": 1168,
        "height": 606
      }
    },
    ...
  ],
  "pagination": {
    "current": 1,
    "next": 2,
    "total_pages": 7
  }
}