Install Jentic One Beta

Connect the Flight Inspiration Search to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Flight Inspiration Search, 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-flight-inspiration-search" | 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-flight-inspiration-search" | 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 Flight Inspiration Search API.

List the cheapest destinations available from a given origin airport

Filter inspiration results by max price, departure date range, and trip duration

Limit results to one-way or round-trip itineraries

GET STARTED

Start building with Flight Inspiration Search API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Flight Inspiration Search API for, with concrete tasks.

★ Cheap Flights From Module on a Travel Homepage

Travel sites populate a 'cheap flights from {origin}' module by calling /shopping/flight-destinations once per popular origin and caching the response for the day. Each card shows the destination name, sample price, and dates - clicking through triggers a fresh Flight Offers Search using the destination IATA returned by the inspiration call.

Call /shopping/flight-destinations with origin=LON and maxPrice=300 and return the top 10 destinations sorted by sample price.

Budget-Constrained Trip Suggestion

Agents and chatbots that ask the user 'how much do you want to spend?' use the maxPrice filter to scope inspiration results to a budget. The endpoint returns only destinations Amadeus has seen at or under the price ceiling, removing the need for the agent to search exhaustively across hundreds of city pairs.

Find five round-trip destinations from LHR with maxPrice=250 GBP departing between 2026-07-01 and 2026-07-31.

Weekend Getaway Generator

Apps that suggest weekend breaks combine duration=1,3 with a near-future departure date range to return only 1-3 day trips. The response is short enough to render in a single screen and links straight to a search-and-book flow when the user picks a city.

Return cheap weekend round-trips from MAD with duration between 1 and 3 nights and a departure between Friday and Sunday next week.

Agent-Driven Trip Discovery via Jentic

An AI travel assistant invoked with 'somewhere warm under 400 from Dublin in February' calls Flight Inspiration Search through Jentic, filters the response by region, and returns 3-5 ideas with sample prices. Jentic handles OAuth and parameter shaping, so the agent only declares the user intent and the constraints.

Call jentic.search('find cheap Amadeus flight destinations from an origin'), load the operation, and execute it with origin=DUB, maxPrice=400, and a February departure window.

Key Endpoints

1 endpoints — the amadeus flight inspiration search api answers the question 'where can i fly from here for cheap?' given an origin iata code, it returns the cheapest destinations amadeus has cached for that origin within an optional date range, max price, duration, and one-way or round-trip filter.

METHOD

PATH

DESCRIPTION

GET

/shopping/flight-destinations

Find the cheapest destinations from a given origin

GET

/shopping/flight-destinations

Find the cheapest destinations from a given origin

Why Jentic?

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

Setup

Wiring the Flight Inspiration Search API by hand means running the Amadeus OAuth 2.0 client_credentials exchange, refreshing the bearer token, and assembling the filter query parameters for GET /shopping/flight-destinations against the correct Amadeus host and version. Through Jentic you install once, import Flight Inspiration Search from the API Directory, store the Amadeus client credentials once, and your agent calls it.

Permission scoping

The origin airport and filters travel as query parameters, not as a resource id in the URL path, so scoping is by operation. You limit the agent to the operations it needs, such as discovering cheap destinations from an origin, and it cannot reach availability, pricing, or booking operations unless you add them.

Credential isolation

Your Amadeus client_id and client_secret are stored once, encrypted, by your own Jentic One instance, which runs the client_credentials exchange and injects a fresh bearer token at execution time. The raw secret never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'find cheap destinations to fly to from Berlin', and Jentic returns the /shopping/flight-destinations operation with its input schema so the agent supplies the origin and filters without scanning the Amadeus docs.

FAQs

Specific to using Flight Inspiration Search API through Jentic.

What authentication does the Flight Inspiration Search API use?

Amadeus Self-Service OAuth 2.0 client_credentials. Exchange your client_id and client_secret at https://api.amadeus.com/v1/security/oauth2/token for a bearer token and send it in the Authorization header. Through Jentic, the credentials live in the encrypted vault and the bearer token is rotated for you on each call to /shopping/flight-destinations.

Are the prices returned bookable in real time?

Not directly. The endpoint returns cached sample prices and dates - to confirm bookability, follow the embedded link or call Flight Offers Search with the chosen origin and destination, then Flight Offers Price before booking.

What are the rate limits for the Flight Inspiration Search API?

Amadeus Self-Service Test caps shopping endpoints at 10 transactions per second per API key with a monthly quota; Production limits scale with the chosen Self-Service plan. Bearer tokens themselves expire after roughly 30 minutes.

How do I find cheap destinations from an origin through Jentic?

Run pip install jentic, then call jentic.search('find cheap Amadeus flight destinations from an origin'), load the operation, and execute it with origin set to the IATA code and any of maxPrice, departureDate, duration, or oneWay as filters. Jentic posts to /shopping/flight-destinations and returns the destination list.

Which origins does this API support?

The Test environment supports a small subset of origins documented in the amadeus4dev/data-collection repository on GitHub. Production supports any IATA city or airport code Amadeus indexes; coverage is best for major European and North American hubs.

Is the Flight Inspiration Search API free?

The Test environment is free with limited monthly quota. Production access is metered per transaction under an Amadeus Self-Service plan; tier pricing is published on the Amadeus for Developers portal.

Can I limit what my agent is allowed to do with the Flight Inspiration Search API?

Yes. Because you run Jentic One yourself and set its rules, you decide which operations and credentials your agent may use. Since the origin and filters travel as query parameters rather than as a resource id in the path, scoping here is by operation: you can grant the agent only the flight-destinations discovery operation on GET /shopping/flight-destinations. It cannot reach any availability, pricing, or booking operations unless you explicitly add them.

Amadeus Flight Inspiration Search

Name: Flight Inspiration Search API
Brand: Flight Inspiration Search
Availability: InStock

Browse all Amadeus APIs

Official vendor OpenAPI document · agent-readyE CommerceStorefrontoauth21 EndpointsREST

For Agents

Discover the cheapest destinations reachable from an origin airport so an agent can suggest where a traveller could fly within budget, without running a full origin-destination search.

Use for: Find the cheapest destinations to fly to from London this summer, Where can I go for under 200 euros from Madrid, Suggest weekend trip ideas from JFK under 500 dollars, I want to discover cheap flight ideas from Paris in March

Not supported: Does not return bookable real-time fares, hotel options, or non-flight content - use only to discover cheap destinations from a given origin airport.

The Amadeus Flight Inspiration Search API answers the question 'where can I fly from here for cheap?' Given an origin IATA code, it returns the cheapest destinations Amadeus has cached for that origin within an optional date range, max price, duration, and one-way or round-trip filter. Each entry includes a sample price, sample dates, and a link to a follow-up Flight Offers Search call. Travel sites use it to power 'cheap flights from London' homepage modules without running an exhaustive search at request time.

Jentic One on Github View OpenAPI Document