Version 1 Release Notes

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

February 2026

New Catalog Search endpoints

• GET /catalog/locations/search – Search the location catalog by name or address (with optional filters like country, geo, postal code, category). Returns a limited catalog payload (id, names, addresses, coordinates, rating, URLs).
• GET /catalog/locations/nearby – Get locations in a geographic area: by radius around a location or lat/lon, or by bounding box. Same catalog-style response; supports category filter, min rating, and sort (e.g. by distance or rating).

How is this different that the Locations Search and Locations Nearby endpoints?

Both catalog endpoints are not limited by allowlists or geofencing, so you can discover and browse locations before committing to an allowlist. Our catalog endpoints are meant to be used for discovery and research into Tripadvisor's locations. A deeper explanation can be found in our guides section here.

Optimizations under the hood

We've also shipped internal optimizations for search across our endpoints. You should see faster, more consistent response behaviors; no changes on calling or interacting with these endpoints.

December 2025

We are excited to release a set of new features for Terra as we close the year.

New Locations Search endpoint

New endpoint to find locations by name or address within specific geographic boundaries. Designed as a discovery function for Tripadvisor's locations. With over 8 million POIs on Tripadvisor, this endpoint can help you validate or check for existing locations, or to help you manage your list of allowed locations (for endusers that are location-bounded)

Key features:

• Find locations by name or address
• Geographic filtering (country code, geo name, postal code)
• Category filtering (restaurants, attractions, hotels)
• Text search with matched value highlighting
• Pagination (max 20 per page)

Locations Search is currently optimized for non-Asian languages in this initial release. Support for Chinese, Japanese, and Korean will be addressed in a later release with specific demand from our endusers. For more information please visit the API reference page.

New Locations Nearby endpoint

Locations Nearby is an endpoint to find locations within a geographic area using radius-based or bounding box search. Designed for mapping and nearby discovery use cases.

Key features:

• Radius-based search (given coordinates or location ID as a centroid parameter)
• Bounding box search for rectangular areas
• Distance and bearing calculations
• Optional photo inclusion for display purposes
• Rating and category filtering
• Flexible sorting (distance, rating)
• Pagination (max 20 per page)

📘

It's worth noting that we will continue to optimize the performance of /locations/search/ and /locations/nearby in the coming months. Notable performance improvements will be made aware to endusers in our release notes and in email communications.

Enhanced Location Reviews request parameters

The reviews endpoint now supports additional filtering and sorting parameters.

New Filtering Parameters:

Sorting Parameters:

Pagination Parameters:

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

Response Schema

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

FeedFileInfo Object

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.