Tripadvisor Hotel Inventory API

openapi: 3.2.0
info:
  title: Tripadvisor Hotel Availability Check Hotel Inventory API
  description: The Tripadvisor Hotel Availability Check (HAC) API allows hotel booking partners to display their availability and pricing on Tripadvisor. This specification describes the endpoints that partners must implement on their servers. When a user views a hotel page, Tripadvisor sends HTTP POST requests to the partner's API to retrieve real-time price and availability data. The API supports batch requests for multiple hotels and requires responses within 5 seconds on average. The current version (v8) provides richer availability data to help partners increase conversions. This spec also covers the hotel inventory endpoint that Tripadvisor queries daily, and the configuration endpoint.
  version: '8'
  contact:
    name: Tripadvisor Connectivity Support
    url: https://developer-tripadvisor.com/connectivity-solutions/hotel-availability-check-api/support/
  termsOfService: https://developer-tripadvisor.com/connectivity-solutions/
servers:
- url: https://{partnerEndpoint}
  description: Partner-hosted endpoint. Tripadvisor sends requests to the partner's server at a URL configured during onboarding.
  variables:
    partnerEndpoint:
      default: api.partner-example.com
      description: The partner's server hostname and base path.
security: []
tags:
- name: Hotel Inventory
  description: Hotel inventory endpoint queried daily by Tripadvisor to import the partner's full list of connected hotels.
paths:
  /hotel_inventory:
    get:
      operationId: getHotelInventory
      summary: Get Hotel Inventory
      description: Returns the partner's full list of hotel properties that are connected for availability checking. Tripadvisor queries this endpoint once per day and matches the returned hotels to Tripadvisor listings. Partners must provide their complete inventory and remove all test properties before the implementation is considered complete.
      tags:
      - Hotel Inventory
      parameters:
      - $ref: '#/components/parameters/ApiVersion'
      - $ref: '#/components/parameters/Lang'
      - name: inventory_type
        in: query
        required: false
        description: The type of inventory integration.
        schema:
          type: string
          enum:
          - tripconnect
          example: tripconnect
      responses:
        '200':
          description: Successful hotel inventory response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HotelInventoryResponse'
components:
  schemas:
    InventoryHotel:
      type: object
      description: A hotel property in the partner's inventory.
      required:
      - ta_id
      - partner_id
      properties:
        ta_id:
          type: integer
          description: The Tripadvisor location ID for this hotel.
        partner_id:
          type: string
          description: The partner's internal identifier for this hotel. Must be consistent between inventory and availability responses.
        name:
          type: string
          description: The name of the hotel property.
        street:
          type: string
          description: The street address of the hotel.
        city:
          type: string
          description: The city where the hotel is located.
        postal:
          type: string
          description: The postal code of the hotel.
        country:
          type: string
          description: The country code of the hotel.
    HotelInventoryResponse:
      type: object
      description: Response containing the partner's complete hotel inventory listing.
      required:
      - api_version
      - hotels
      properties:
        api_version:
          type: integer
          description: The API version of this response.
          example: 8
        lang:
          type: string
          description: The language of the response content.
          example: en
        hotels:
          type: array
          description: Array of hotel objects representing the partner's full inventory.
          items:
            $ref: '#/components/schemas/InventoryHotel'
  parameters:
    ApiVersion:
      name: api_version
      in: query
      required: true
      description: The API version number. Current version is 8.
      schema:
        type: integer
        enum:
        - 8
        example: 8
    Lang:
      name: lang
      in: query
      required: false
      description: The language code for the response content.
      schema:
        type: string
        default: en
        example: en
externalDocs:
  description: Tripadvisor HAC API Documentation
  url: https://developer-tripadvisor.com/connectivity-solutions/hotel-availability-check-api/documentation/