Apinoa Docs

Place

Get one place's details from Tripadvisor.

View raw .mdx
GET | POST /v1/tripadvisor/place

Send parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.

Request

curl "https://gateway.apinoa.com/v1/tripadvisor/place?id=143336&country=US" \
  -H "x-api-key: $APINOA_API_KEY"

Parameters

ParameterTypeRequiredNotes
countryenumThe market, as an ISO 3166 country code. US GB CA AU IN IE DE FR IT ES NL BR MX JP KR
idstringThe place's id, as places returns it (a Tripadvisor link is taken too).
langstringInterface language.
urlstringA Tripadvisor place link.

The same parameters, and every response type, are in the OpenAPI document.

Response

Returns Place in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "success": true,
  "data": {
    "id": "143336",
    "name": "Paris Las Vegas",
    "url": "https://www.tripadvisor.com/Hotel_Review-g45963-d143336-Reviews-Paris_Las_Vegas-Las_Vegas_…",
    "address": {
      "street": "3655 S Las Vegas Blvd",
      "city": "Las Vegas",
      "region": "Nevada",
      "postalCode": "89109",
      "country": "US",
      "full": "3655 S Las Vegas Blvd, Las Vegas, NV 89109"
    },
    "coordinates": {"lat": 36.11246, "lng": -115.17071},
    "rating": 3.9,
    "reviewCount": 40012,
    "photos": ["https://dynamic-media-cdn.tripadvisor.com/media/photo-o/2f/ac/a0/69/paris-las-vegas.jpg?w=…"],
    "description": "Paris Las Vegas Hotel - A Caesars Rewards Destination. Experience everything you love abou…",
    "lang": "en",
    "ext": {
      "type": "hotel",
      "placeType": "ACCOMMODATION",
      "parent": {"id": "45963", "name": "Las Vegas"},
      "neighborhoods": ["The Strip"],
      "email": "totalrewards@custhelp.com",
      "ratings": {
        "starCounts": {"1": 2772, "2": 2833, "3": 5948, "4": 11959, "5": 16500},
        "distribution": {"1": 6.93, "2": 7.08, "3": 14.87, "4": 29.89, "5": 41.24},
        "subRatings": {
          "activitiesAndGym": 3.5,
          "cleanliness": 4.2,
          "dining": 3.9,
          "location": 4.7,
          "pool": 3.7,
          "room": 4,
          "service": 3.9,
          "sleep": 4.2,
          "value": 3.9
        }
      },
      "nearby": {
        "neighborhood": {
          "name": "The Strip",
          "description": "Las Vegas Strip, a neon wonderland that never sleeps, is the epicenter of thrill and enter…"
        },
        "hotels": [
          {
            "id": "1639337",
            "name": "Hilton Grand Vacations Club Elara Center Strip Las Vegas",
            "url": "https://www.tripadvisor.com/Hotel_Review-g45963-d1639337-Reviews-Hilton_Grand_Vacations_Cl…",
            "coordinates": {"lat": 36.10882, "lng": -115.16833},
            "photo": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/15/22/91/ac/pool.jpg?w=4950&h=3300…",
            "rating": 4.3,
            "reviewCount": 8809,
            "award": {"type": "COE", "year": 2026}
          }
        ],
        "attractions": [
          {
            "id": "553008",
            "name": "Paris Las Vegas Wedding Chapel",
            "url": "https://www.tripadvisor.com/Attraction_Review-g45963-d553008-Reviews-Paris_Las_Vegas_Weddi…",
            "coordinates": {"lat": 36.112034, "lng": -115.171036},
            "photo": "https://dynamic-media-cdn.tripadvisor.com/media/photo-o/28/fd/2d/eb/arc-de-triomphe.jpg?w=…",
            "rating": 4.6,
            "reviewCount": 55,
            "distance": 0.034517966
          }
        ],
        "landmarks": [{"name": "Fountains of Bellagio"}],
        "restaurantsUrl": "https://www.tripadvisor.com/RestaurantsNear-g45963-d143336-Paris_Las_Vegas-Las_Vegas_Nevad…",
        "hotelsUrl": "https://www.tripadvisor.com/HotelsNear-g45963-d143336-Paris_Las_Vegas-Las_Vegas_Nevada.htm…",
        "attractionsUrl": "https://www.tripadvisor.com/ClientLink?value=b0JIXy9BdHRyYWN0aW9uc19VMGU%3D"
      },
      "ranking": {
        "text": "#164 of 261 hotels in Las Vegas",
        "url": "https://www.tripadvisor.com/Hotels-g45963-a_sort.POPULARITY-Las_Vegas_Nevada-Hotels.html"
      },
      "hotel": {
        "accommodationType": "T_HOTEL",
        "categoryRanking": "#164 of 261 hotels in Las Vegas",
        "starRating": {"tagIds": [9566], "source": "This property is classified according to Giata."},
        "subRatings": {
          "cleanliness": 4.190542,
          "location": 4.6725383,
          "rooms": 3.9813929,
          "service": 3.9386554,
          "sleepQuality": 4.166858,
          "value": 3.9060726
        },
        "styles": [{"name": "Family", "rankInCity": 109, "score": 1.9675850720952188}],
        "amenities": [{"group": "Room features", "label": "Blackout curtains", "category": "Comfort", "highlighted": true}],
        "roomFeaturesUrl": "https://www.tripadvisor.com/Hotel_Feature-g45963-d143336-zft1-Paris_Las_Vegas.html",
        "parents": [
          {
            "id": "45963",
            "hotelsUrl": "https://www.tripadvisor.com/Hotels-g45963-Las_Vegas_Nevada-Hotels.html"
          }
        ]
      }
    },
    "attributes": [{"group": "Room features", "label": "Blackout curtains"}],
    "verifiedOwner": true
  }
}

Errors

StatusCodeMeaning
400INVALID_PARAMSA parameter is missing, unknown or out of range, or the engine does not take it. The message names it.
401UNAUTHORIZEDThe x-api-key header is missing, or the key is revoked or unknown.
402INSUFFICIENT_BALANCEThe balance does not cover this call. Top up in the dashboard.
404NOT_FOUNDThe place does not exist.
429MARKETPLACE_SATURATEDToo many concurrent calls. Retry after the Retry-After seconds.
502UPSTREAM_ERRORThe engine answered with something unusable. Retry with backoff.
503SERVICE_UNAVAILABLEA temporary failure. Retry with backoff.

Every code is listed in Errors. Failed calls are not billed.

Pricing

Price $0.0012 per call. List price; the rate steps down above 1,000 calls a day.

Notes

  • Pass id from places, or a Tripadvisor link as id or url.

On this page