Skip to content
All endpoints

List ranked TripAdvisor restaurants & hospitality reputation by geo_id

GET/v1/tripadvisor/restaurants5 Credits / restaurant (0 Credits on empty)($0.0005 / restaurant ($0.20–$0.50 / 1K restaurants))· Updated 2026-11-15

Direct Answer · Engineering Summary

GET /v1/tripadvisor/restaurants lists ranked hospitality & dining venues on TripAdvisor for any destination geo_id (such as 187147 for Paris), returning location_id, name, bubble rating, review_count, price_level, cuisines, open status, and Travellers' Choice award badges at 5 Credits per venue ($0.20–$0.50 per 1,000 venues).

Honest Trade-Offs & Scope Boundaries

  • →Requires a numeric TripAdvisor geo_id (obtainable in one call via GET /v1/tripadvisor/search?query=Paris).
  • →Returns ranked venue reputation metrics and award status rather than table reservation availability.
  • →Cached for 4 hours by default; paid accounts can pass ?fresh=true for live re-indexing.

Returns TripAdvisor restaurant listings for a destination geo_id (e.g. 187147 for Paris) with bubble rating, total review count, price tier, cuisine tags, open status, and Travellers' Choice award indicators.

Parameters

  • geo_idstringrequired

    TripAdvisor destination geo_id from /v1/tripadvisor/search (e.g. 187147 for Paris).

    Example: 187147

  • pageinteger

    1-based page number.

    Example: 1

  • limitinteger (1 to 50)

    Maximum restaurants to return (1–50).

    Example: 20

Example Request (cURL / Python / JavaScript)

curl "https://api.reviewsdataapi.com/v1/tripadvisor/restaurants?geo_id=187147" \
  -H "x-api-key: rv_live_your_api_key"

Live Response Preview

{
  "code": 0,
  "provider": "https://reviewsdataapi.com",
  "status": "ok",
  "msg": "success",
  "data": {
    "platform": "tripadvisor",
    "geo_id": "187147",
    "restaurants": [
      {
        "location_id": "14039269",
        "geo_id": "187147",
        "name": "Can Alegria Paris",
        "rating": 4.8,
        "review_count": 1647,
        "popularity_rank": 117,
        "price_range": "$$ - $$$",
        "cuisines": [
          "French",
          "Mediterranean",
          "Vegetarian friendly"
        ],
        "neighborhood": "Saint-Georges",
        "travellers_choice_badge": "TRAVELLER_CHOICE 2026",
        "tripadvisor_url": "https://www.tripadvisor.com/Restaurant_Review-g187147-d14039269"
      },
      {
        "location_id": "34162331",
        "geo_id": "187147",
        "name": "Pizzeria Arrivederci (4ème)",
        "rating": 4.9,
        "review_count": 749,
        "popularity_rank": 1,
        "price_range": "$$ - $$$",
        "cuisines": [
          "Italian",
          "Pizza"
        ],
        "neighborhood": "Le Marais",
        "travellers_choice_badge": null,
        "tripadvisor_url": "https://www.tripadvisor.com/Restaurant_Review-g187147-d34162331"
      }
    ]
  },
  "meta": {
    "request_id": "a44353f9-f188-454c-9a44-9ac3fbf08069",
    "endpoint": "/v1/tripadvisor/restaurants",
    "items_returned": 20,
    "credits_charged": 100,
    "cached": true,
    "took_ms": 1
  }
}

Response Fields

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

FieldTypeSample / Notes
codeintegerExample: 0
providerstringExample: https://reviewsdataapi.com
statusstringExample: ok
msgstringExample: success
dataobject
platformstringExample: tripadvisor
geo_idstringExample: 187147
restaurantsarray of object
location_idstringExample: 14039269
geo_idstringExample: 187147
namestringExample: Can Alegria Paris
ratingnumberExample: 4.8
review_countintegerExample: 1647
popularity_rankintegerExample: 117
price_rangestringExample: $$ - $$$
cuisinesarray of string
neighborhoodstringExample: Saint-Georges
travellers_choice_badgestringExample: TRAVELLER_CHOICE 2026
tripadvisor_urlstringExample: https://www.tripadvisor.com/Restaurant_Review-g187147-d14039
metaobject
request_idstringExample: a44353f9-f188-454c-9a44-9ac3fbf08069
endpointstringExample: /v1/tripadvisor/restaurants
items_returnedintegerExample: 20
credits_chargedintegerExample: 100
cachedbooleanExample: true
took_msintegerExample: 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.