List Files requests

A List Files request returns the feed files currently available to your account. A filename from this response is required by both download endpoints.

Feed endpoints are served from a different base URL to the content endpoints, and use a separate feed API key.

A request is an HTTP GET to a URL in the form:

https://terra.tripadvisor.com/api/feeds/files/list

List Files responses

The response is a paged object. Each entry in data carries filename and filesize only. filesize is the compressed size in bytes.

Pages are 1-based and size defaults to 5, so raise it when more files are expected.

{
  "data": [
    { "filename": "location.json.gz", "filesize": 1048576 }
  ],
  "pagination": {
    "page": 1,
    "size": 5,
    "total_elements": 6,
    "total_pages": 2
  }
}

There is no last-modified field. Use the dated reviews filename to distinguish one day's file from another.

Note: feeds require the Innovate or Transform package and a feed configuration arranged with your account team.

Note: feed files are retained for a limited window after generation. See the Guide for Downloading Feeds for filenames and retention.

Examples

List the available files

curl "https://terra.tripadvisor.com/api/feeds/files/list?version=1&size=20" \
  -H "X-API-Key: FEED_API_KEY"

Related

• Guide for Downloading Feeds — filenames, retention and the full workflow
• Redirect to Feed File — download immediately
• Feed File URL — retrieve a presigned URL instead