POSTFlight Search Aggregate
Retrieve aggregated flight search results for map visualization. Groups results by departure or arrival airport.
POST https://ai-api.pointsyeah.com/explorer/search/aggregate
Use `group_by: "arrival_airport"` or `group_by: "departure_airport"` to control aggregation.Set `pagination.page_size` to a large value (e.g. 9999) to get all aggregated points in one request.
Parameters
ParameterValue
departureobjectrequired
Departure location filter. Same structure as Flight Search.
airportsarray
IATA airport codes
countriesarray
Country codes
continentsarray
Continent codes
regionsarray
Region identifiers
statesarray
US state codes
arrivalobjectrequired
Arrival location filter. Same structure as departure.
airportsarray
IATA airport codes
countriesarray
Country codes
continentsarray
Continent codes
regionsarray
Region identifiers
statesarray
US state codes
start_datedaterequired
Start of search window, YYYY-MM-DD.
end_datedaterequired
End of search window, YYYY-MM-DD.
cabinsarray
Cabin classes: Economy, Premium, Business, First.
sortstring
Sort order.Default: miles
group_bystringrequired
Aggregation dimension.
arrival_airportdeparture_airport
collectionboolean
Include partner collection results.Default: false
paginationobjectrequired
Pagination controls.
pagenumberrequired
Page number.Default: 1
page_sizenumberrequired
Results per page. Use 9999 for all.Default: 9999