Search TripAdvisor destinations, hotels, restaurants & geo_id locations

GET/v1/tripadvisor/search5 Credits / location (0 Credits on empty)($0.0005 / location ($0.20–$0.50 / 1K locations))· Updated 2026-11-15

Direct Answer · Engineering Summary

GET /v1/tripadvisor/search resolves destination cities, hotels, attractions, and restaurants on TripAdvisor into canonical location_id / geo_id identifiers with bubble ratings, review counts, addresses, and GPS coordinates for 5 Credits per returned location ($0.20–$0.50 per 1,000 locations).

Honest Trade-Offs & Scope Boundaries

→Designed for resolving geo_id and location metadata before calling GET /v1/tripadvisor/restaurants.
→Serves 4-hour warm cache hits in <30ms to eliminate redundant directory lookups.
→Covers public TripAdvisor hospitality listings globally; private OTA booking inventory rates are excluded.

Resolves cities, hotels, attractions, and restaurants on TripAdvisor into canonical geo_id and location_id records with bubble ratings, review counts, thumbnails, and GPS coordinates.

Parameters

querystringrequired
City, hotel, landmark, or restaurant name (e.g. Paris, Ritz Paris).
Example: Paris
langstring
Locale code (default en_US).
Example: en_US
limitinteger (1 to 30)
Maximum locations to return (1–30).
Example: 10

Example Request (cURL / Python / JavaScript)

curl "https://api.reviewsdataapi.com/v1/tripadvisor/search?query=Paris" \
  -H "x-api-key: rv_live_your_api_key"

import requests

res = requests.get(
    "https://api.reviewsdataapi.com/v1/tripadvisor/search?query=Paris",
    headers={"x-api-key": "rv_live_your_api_key"},
    timeout=30,
)
print(res.json())

const res = await fetch("https://api.reviewsdataapi.com/v1/tripadvisor/search?query=Paris", {
  headers: { "x-api-key": "rv_live_your_api_key" },
});
const data = await res.json();
console.log(data);

Live Response Preview

{
  "code": 0,
  "provider": "https://reviewsdataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "platform": "tripadvisor",
    "query": "Paris",
    "locations": [
      {
        "location_id": "187147",
        "geo_id": "187147",
        "result_type": "geos",
        "name": "Paris",
        "location_string": "Paris, Ile-de-France",
        "rating": null,
        "review_count": 5645698,
        "timezone": "Europe/Paris",
        "coordinates": {
          "latitude": 48.857037,
          "longitude": 2.349401
        },
        "photo_url": "https://media-cdn.tripadvisor.com/media/photo-s/17/15/6d/d6/paris.jpg"
      },
      {
        "location_id": "189229",
        "geo_id": "189229",
        "result_type": "things_to_do",
        "name": "The Paris Catacombs",
        "location_string": "Paris, Ile-de-France",
        "rating": 4.1,
        "review_count": 8537,
        "timezone": "Europe/Paris",
        "coordinates": {
          "latitude": 48.83387,
          "longitude": 2.332481
        },
        "photo_url": "https://media-cdn.tripadvisor.com/media/photo-s/01/00/c4/f4/a-place-to-pray.jpg"
      }
    ]
  },
  "meta": {
    "request_id": "7ff97937-3631-4e67-a80a-fb442a4cfa85",
    "endpoint": "/v1/tripadvisor/search",
    "items_returned": 20,
    "credits_charged": 100,
    "cached": true,
    "took_ms": 1
  }
}

Response Fields

Normalized cross-platform reputation, star distribution, and sentiment JSON payload.

Field	Type	Sample / Notes
`code`	integer	Example: 0
`provider`	string	Example: https://reviewsdataapi.com
`status`	string	Example: ok
`msg`	string	Example: success
`data`	object
`platform`	string	Example: tripadvisor
`query`	string	Example: Paris
`locations`	array of object
`location_id`	string	Example: 187147
`geo_id`	string	Example: 187147
`result_type`	string	Example: geos
`name`	string	Example: Paris
`location_string`	string	Example: Paris, Ile-de-France
`rating`	string	Optional field (nullable)
`review_count`	integer	Example: 5645698
`timezone`	string	Example: Europe/Paris
`coordinates`	object
`photo_url`	string	Example: https://media-cdn.tripadvisor.com/media/photo-s/17/15/6d/d6/
`meta`	object
`request_id`	string	Example: 7ff97937-3631-4e67-a80a-fb442a4cfa85
`endpoint`	string	Example: /v1/tripadvisor/search
`items_returned`	integer	Example: 20
`credits_charged`	integer	Example: 100
`cached`	boolean	Example: true
`took_ms`	integer	Example: 1

Status Codes

200: Normalized cross-platform reputation, star distribution, and sentiment JSON payload.
400: Missing or invalid query parameter (0 credits charged).
401: Missing or invalid rv_live_ API key.
402: Insufficient credit balance.