Tour Operator Quickstart
Get your TO account connected to hotel data and your first API integration running in under an hour.
Step 1 — Register as a Tour Operator
Register at app.ananas-gds.com/register and select Tour Operator as your company type. Complete your profile — the marketplace profile is what hotel partners see when reviewing your connection request.
Step 2 — Discover & Connect Hotels
Go to Market & Partners → Market to browse available accommodation providers. Filter by country, verified status, or star rating. Send connection requests to hotels you work with. Once a hotel accepts, the contract is active and you can access their data.
Already working with a hotel?
Ask the hotel to send you a connection request from their Partners page — this speeds up the process if they haven't found your profile yet.
Step 3 — Create an API Key
Go to Developer Tools → API Keys and create a key. Select which data types to enable: fact sheets, stop sale, and/or photos. The generated token is used in URL-based API requests to pull data from all connected hotels.
Step 4 — Set Up Mapping (If Needed)
If your internal system uses its own hotel codes, go to Partners → Mapping. Map each partner hotel's Ananas GDS property to your internal hotel code. You can also add room-level mapping if your booking system requires event codes for individual room types.
Step 5 — Pull Hotel Data
Use the v1 API to pull fact sheets, availability, and photos for all connected properties:
GET https://app.ananas-gds.com/api/v1/facts/{your-api-token}/
GET https://app.ananas-gds.com/api/v1/stop-sale/{your-api-token}/
GET https://app.ananas-gds.com/api/v1/photos/{your-api-token}/
The response includes all properties your token has access to. Filter by property ID in your integration layer. See API Integration for full integration guidance.
Step 6 — Override Facts (Optional)
If a hotel's published data needs adjustment for your system (translated room names, different meal plan codes, custom categorisation), use the Override Facts feature in Partners → [Hotel Name] → Override Facts. Overrides are applied at query time — the hotel's source data is unchanged.