Install Jentic One Beta

Connect the Travel Recommendations API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Travel Recommendations API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Famadeus.com%2Famadeus-travel-recommendations" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Famadeus.com%2Famadeus-travel-recommendations" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Travel Recommendations API.

Suggest destinations from a seed list of cityCodes the traveller already likes

Return ranked recommendations with a relevance score per suggestion

Filter recommendations by traveller country code for region-aware suggestions

GET STARTED

Start building with Travel Recommendations API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Travel Recommendations API for, with concrete tasks.

★ Personalised inspiration carousel

Power a 'destinations you might love' carousel on a travel app's homepage by feeding Travel Recommendations the city codes of the user's recent searches or bookings. The API returns ranked suggestions with relevance scores so the carousel can prioritise the strongest recommendations and refresh them as the user's history grows. Implementation is a single GET call per user session.

Call GET /reference-data/recommended-locations with cityCodes=PAR,ROM and return the top 6 recommended destinations with relevance scores.

Destination cross-sell after booking

After a user books a hotel or flight, surface recommended next destinations using the booking's city as the seed. This converts a single transaction into a future-trip nurture - useful for OTAs and corporate travel platforms that want to extend the user lifecycle. Combine with email or push notifications timed for a few weeks after the booked trip ends.

Given the user just booked a stay in BCN, call Travel Recommendations with cityCodes=BCN and return the top 3 destinations to suggest in a follow-up email.

AI travel agent destination picker

When an AI travel agent is asked 'where should I go for a long weekend' with no specific destination, Travel Recommendations grounds the answer in real similarity data rather than the model's prior. The agent supplies the user's previously enjoyed cities as the seed, retrieves ranked suggestions, and presents them with a citation of the relevance score. This avoids hallucinated city picks and lets the user confirm before chaining into Hotel Search.

Use Jentic to search 'recommend a destination', execute Travel Recommendations with the user's preferred city codes, and return the top 3 suggestions with relevance scores.

Key Endpoints

1 endpoints — the amadeus travel recommendations api returns suggested destinations for a traveller based on cities they already like.

METHOD

PATH

DESCRIPTION

GET

/reference-data/recommended-locations

Get recommended destinations for a seed of cities

GET

/reference-data/recommended-locations

Get recommended destinations for a seed of cities

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Amadeus Travel Recommendations API by hand means running the OAuth2 client-credentials flow to obtain and refresh tokens and targeting the correct Amadeus host before you can rank a single destination. Through Jentic you install once, import Travel Recommendations from the API Directory, store the Amadeus client id and secret once, and your agent calls it.

Permission scoping

This API exposes a single read-only recommendation lookup, so scope the agent to just the operation it needs, the recommended-locations call at /reference-data/recommended-locations. It returns ranked destinations from a seed of cities and does not price, hold, or book anything.

Credential isolation

Your Amadeus client id and secret are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'recommend a destination from these cities', and Jentic returns the Travel Recommendations operation with its cityCodes, travelerCountryCode, and destinationCountryCodes parameter schema so the agent calls it directly without reading the Amadeus docs.

FAQs

Specific to using Travel Recommendations API through Jentic.

What authentication does the Travel Recommendations API use?

OAuth 2.0 client credentials. Exchange your Amadeus API key and secret for a bearer access token via the authorization endpoint, then pass it as the Authorization header on each call. Through Jentic, the client secret stays encrypted in the vault and only a scoped token is exposed to the agent.

What inputs does the recommendation endpoint accept?

GET /reference-data/recommended-locations accepts cityCodes (a comma-separated list of IATA city codes the traveller likes) and optionally travelerCountryCode and destinationCountryCodes filters. The response is a ranked list of destinations with a relevance score for each.

Can I bias recommendations to a region?

Yes. Use the destinationCountryCodes parameter to scope suggestions to one or more ISO country codes - useful when the traveller has a constraint like 'within Europe' or 'domestic only'.

What are the rate limits for the Travel Recommendations API?

Amadeus enforces per-second and per-month transaction quotas that vary by environment. The test environment (test.api.amadeus.com/v1) has low quotas for development; production limits are set in your Amadeus for Developers contract.

How do I recommend a destination through Jentic?

Install with pip install jentic, then search 'recommend a destination' to discover the Travel Recommendations operation. Load its schema and execute with cityCodes seeded from the user's history. Jentic returns parsed ranked suggestions ready to render. Get started with Jentic One, the self-hosted execution layer.

Is the Travel Recommendations API free?

Amadeus offers a free self-service tier suitable for prototyping. Production usage requires upgrading to a paid plan in the Amadeus for Developers portal; pricing depends on call volume and contract.

Can I limit what my agent is allowed to do with the Travel Recommendations API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent can use, and this API exposes only a single read-only lookup, the recommended-locations call at GET /reference-data/recommended-locations. You can scope the agent to just that operation, so it ranks destinations from a seed of cities and nothing more. It does not price, hold, or book anything, and your Amadeus client id and secret stay encrypted in your instance and are injected only at execution time.

Amadeus Travel Recommendations API

Name: Travel Recommendations API
Brand: Travel Recommendations API
Availability: InStock

Browse all Amadeus APIs

Official vendor OpenAPI document · agent-readyData EnrichmentData Transformationoauth21 EndpointsREST

For Agents

Suggest destinations for a traveller based on cities they have liked or visited, returning ranked recommendations with relevance scores for inspiration surfaces.

Use for: Suggest destinations a traveller would like based on their previous trips, Get recommended cities for someone who likes Paris and Rome, Retrieve travel recommendations for a customer profile, Find similar destinations to a city the user already booked

Not supported: Does not return prices, availability, or bookings - use for ranked destination recommendations from a seed of cities only.

The Amadeus Travel Recommendations API returns suggested destinations for a traveller based on cities they already like. Provide a seed of one or more city codes and the API returns destinations chosen by other travellers with similar preferences, complete with relevance scores. The single endpoint is designed for inspiration surfaces - homepage carousels, 'where next' modules, and AI travel concierges that need to suggest destinations rather than wait for the user to pick one.

Jentic One on Github View OpenAPI Document