API & integrations

Connect your systems. Share hotel data without manual work.

Ananas GDS provides a structured data layer between hotels and their partners. Information flows automatically across systems, APIs, and platforms — so your teams stop copying data between tools and start focusing on the work that matters.

How the data layer works.

01

Input

Hotels provide data through the Ananas GDS platform interface, structured manual input, or file-based imports from existing systems.

02

Structured data layer

Ananas GDS standardizes and organizes all data into a consistent, structured format. One version. One source of truth. Always current.

03

Distribution

Partners access data through the partner interface, JSON / XML API responses, website widget embed, or scheduled automatic pulls.

REST API

Clean, simple, token-based.

Authentication

All API endpoints use a per-partnership token passed as a URL path parameter. The token is auto-generated when a partnership contract is accepted. One token per partnership. No API keys stored in frontend code.

Base URL & formats

https://app.ananas-gds.com/api/

Response formats: JSON (default) or XML via ?format=xml

Endpoint 1 — Fact Sheet Data

GET https://app.ananas-gds.com/api/facts/published-partners/ {token} /

Parameters

  • token (required) — your partnership token
  • format (optional) — json or xml
  • property_id (optional) — filter by property

Returns

Complete structured fact sheet data for all properties accessible via the token.

Endpoint 2 — Property Photos

GET https://app.ananas-gds.com/api/facts/partners-photos/ {token} /

Parameters

  • token (required)
  • format (optional)
  • property_id (optional)
  • category (optional) — exterior, room, pool, restaurant, beach, spa, lobby, other

Returns

Photo URLs organized by category for all accessible properties.

Endpoint 3 — Stop Sale / Availability

GET https://app.ananas-gds.com/api/stop-sale/StopSale-Export/ {token} /

Parameters

  • token (required)
  • format (optional)
  • property_id (optional)
  • date_from / date_to (optional) — YYYY-MM-DD

Returns

Availability calendar data with status per room type per date.

Security note. Keep partnership tokens private. Tokens grant read access to your partner's published data. Never embed tokens in public-facing frontend code. Use them in server-side requests only.

Embed your fact sheet on your website.

Hotel accounts can embed a live version of their Ananas GDS fact sheet directly on their hotel website using a single HTML snippet. The widget updates automatically whenever you update your data in the platform — no manual updates to your website required.

Full API documentation

<!-- Embed on your website -->
< div id="ananas-widget"
    data-token=" YOUR_TOKEN "></ div >
< script src=
  "https://app.ananas-gds.com/widget/embed.js">
</ script >

Multiple ways to connect.

Manual input

Use the Ananas GDS interface directly. No integration required.

File import

Import structured data from spreadsheets or system exports to populate your fact sheet.

REST API

Full programmatic access for tour operators and technical partners.

Website widget

Embed live fact sheet data on your hotel website.

Webhooks

HMAC-signed delivery with retry, so your systems hear about a change the moment it happens.

PMS & standards

Direct connectors into the systems your partners already run.

Mews

Live PMS connector, verified against Mews' public demo environment.

Apaleo

Built and connectable — Apaleo offers a free instant self-serve sandbox to test against.

Cloudbeds

Built and connectable, pending Cloudbeds' partner sandbox approval.

AlpineBits

FreeRooms and handshake support for the open standard the DACH market runs on.

MCP server for AI developer tools

Ananas GDS also runs a Model Context Protocol server — 24 tools across account, hotel, tour-operator, and developer actions, authenticated with a long-lived Personal Access Token instead of a short-lived session token. It works with Claude Code today, so your AI coding assistant can query and act on your Ananas data directly.

Don't see your system? PMS connectors are actively expanding — talk to us about a direct integration.

Build your integration today.

Create a free account, connect with a partner, and generate your first token in minutes.

Create Free Account