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
dataobject, 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
| Parameter | Type | Required | Description |
|---|---|---|---|
page | Integer | No | Page number (0-indexed) |
size | Integer | No | Number 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
| Field | Type | Description |
|---|---|---|
filename | String | Name of the feed file |
filesize | Long | Size 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.