Version 1 Release Notes

Release notes highlight improvement across the Tripadvisor Terra platform. Releases typically are made to all versions unless explicitly mentioned.

November 2025

Multi-GET Endpoints for Locations and Geos

We've introduced multi-GET endpoints for Locations and Geos, allowing you to fetch multiple resources in a single API request. This reduces the number of API calls needed when retrieving multiple locations or geos, improving efficiency and reducing latency.

Locations Multi-GET

GET /locations?version=1&id={id},{id}

Geos Multi-GET

GET /geos?version=1&id={id},{id}

Please note

  • Multi-GET endpoint response schemas encapsulates multiple locations in a data object, which the single GET endpoints do not.
  • If a requested ID doesn't exist or isn't accessible, it will be omitted from the response array. The response may contain fewer items than requested IDs.

October 2025

New Endpoint: List Feed Files

GET /files/list?version=BETA — Lists available feed files for your account.

Request Parameters

ParameterTypeRequiredDescription
pageIntegerNoPage number (0-indexed)
sizeIntegerNoNumber of items per page

Response Schema

{
  "content": [
    {
      "filename": "locations_2025-10-30.gz",
      "filesize": 1048576
    }
  ],
  "metadata": {
    "page": 0,
    "size": 20,
    "total_elements": 45,
    "total_pages": 3
  }
}

FeedFileInfo Object

FieldTypeDescription
filenameStringName of the feed file
filesizeLongSize of the file in bytes

Response Cleanup

Empty objects and null fields are omitted in responses across all endpoints (smaller payloads, clearer data). If a field is absent, no data is available for it.

Photos

Photo results are ranked for better relevance and consistency across endpoints.