Amadeus Flight Inspiration Search
Browse all Amadeus APIs✓ Official Vendor SpecE 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.
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.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic 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
Surface a sample price and sample dates for each suggested destination
Hand off a chosen destination to Flight Offers Search using the embedded follow-up link
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?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Amadeus client_id and client_secret are stored encrypted in the Jentic vault. Jentic runs the OAuth 2.0 client_credentials flow and refreshes the bearer token automatically before each inspiration query.
Intent-based discovery
Agents search Jentic by intent ('find cheap Amadeus flight destinations from an origin') and Jentic returns the /shopping/flight-destinations operation with its full filter parameter list.
Time to first call
Direct Amadeus integration: 1 day for OAuth and parameter handling. Through Jentic: under 30 minutes — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
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.
GET STARTED