Market intelligence

Search flights

Changed on

Searches flight itineraries between cities of interest and returns trips, fares, timing, etc.

<span>⚡ <strong>Rate limit:</strong> 120 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> 2 credits per search <span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

post/v1/flights/search

Request

  • Base URL
    https://api.fiber.ai
  • URL
    https://api.fiber.ai/v1/flights/search
  • Auth
    none declared

Request body

apiKeystring required

Your Fiber API key

travelClass'economy' | 'premiumEconomy' | 'business' | 'first' | 'null' nullable

Preferred cabin class. Omit to consider flights across all cabin classes.

adultsinteger

Number of adult passengers (ages 12+).

childreninteger

Number of child passengers (ages 2-11).

infantsInSeatinteger

Number of infants (under 2) with their own seat.

infantsOnLapinteger

Number of infants (under 2) on an adult's lap.

maxStopsinteger nullable

Maximum number of stops allowed. 0 = nonstop only, 1 = one stop or fewer, 2 = two stops or fewer. Omit to allow any number of stops.

sortBy'top' | 'price' | 'departureTime' | 'arrivalTime' | 'duration' | 'emissions' | 'null' nullable

Sort criterion for results. 'top' ranks by overall value. 'price' sorts cheapest first. 'departureTime' and 'arrivalTime' sort earliest first. 'duration' sorts shortest first. 'emissions' sorts lowest carbon first. Direction is always ascending and cannot be changed. Omit to sort by 'top'.

minCarryOnBagsinteger nullable

Minimum carry-on bags the itinerary must include. Omit for no requirement.

minCheckedBagsinteger nullable

Minimum checked bags the itinerary must include. Omit for no requirement. Honored on a best-effort basis: not every itinerary exposes checked-bag inclusion.

maxPriceinteger nullable

Maximum total itinerary price in whole currency units. You may want to set currencyCode as well so the price cap is in the currency you expect (default currency is USD). Omit for no price cap.

maxFlightDurationMinutesinteger nullable

Maximum total flight duration in minutes. Omit for no limit.

onlyShowLowEmissionFlightsboolean

When true, only return flights with lower-than-typical carbon emissions. When false (default), return all flights.

showHiddenboolean

When true, include itineraries that would normally be hidden (e.g. very late or undesirable schedules).

hideSeparateTicketsboolean

When true, drop itineraries that combine separately-issued tickets (which carry higher disruption risk).

currencyCodestring

ISO 4217 currency code for prices in the response (e.g. 'EUR', 'GBP', 'CAD'). Case-insensitive. Defaults to USD.

searchMarketCountryCodestring

ISO 3166-1 alpha-3 country code that sets the search market (e.g. 'GBR', 'BRA'). This affects regional pricing and flight availability — the same route may show different prices and options depending on the market. Case-insensitive.

languageCodestring

Language for search results (airport names, airline names, labels). Pass a BCP-47 language tag such as 'en', 'en-US', 'pt-BR', 'zh-CN', 'ja', 'ko', 'fr', 'de', 'es'.

nextPageTokenstring nullable

Token to retrieve the next page. Pass as nextPageToken in the next request. Null if no more pages.

Response

Default Response

advicestring[] nullable

Tips, recommendations, and suggestions for using this API effectively.

Changes

  • 4002aa81d4fbRevision changes
    • breaking

      the response property became nullable for the status

    • breaking

      the response property became optional for the status

    • info

      the response's property default value was removed for the status

  • fda5277ff34fRevision changes
    • breaking

      removed subschema #1 subschema #2 subschema #3 from the request property oneOf list

    • info

      added subschema #1 subschema #2 subschema #3 to the request property oneOf list