almosafer.com APIalmosafer.com ↗
Search Almosafer flights, get fare calendars, and look up airport/airline info via 3 structured endpoints returning real-time pricing and itinerary data.
curl -X GET 'https://api.parse.bot/scraper/775b2738-2d03-4e34-a269-8c51b572e0a2/search_flights?origin=RUH&destination=JED&departure_date=2026-05-10' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for flights between airports with optional filtering by airline, stops, price, and more. Supports one-way and round-trip searches across all cabin classes. Returns flight itineraries sorted by the specified criteria.
| Param | Type | Description |
|---|---|---|
| cabin | string | Cabin class: Economy, Business, First |
| adults | integer | Number of adult passengers |
| originrequired | string | Origin airport IATA code (e.g., RUH, DXB, JFK) |
| infants | integer | Number of infant passengers (under 2) |
| sort_by | string | Sort results by: price, duration, stops |
| airlines | string | Filter by airline codes, comma-separated (e.g., SV,F3,XY) |
| children | integer | Number of child passengers (2-11 years) |
| currency | string | Price currency code (USD, SAR, EUR, etc.) |
| max_price | number | Maximum total price filter |
| max_stops | integer | Maximum number of stops (0 for nonstop) |
| min_price | number | Minimum total price filter |
| destinationrequired | string | Destination airport IATA code (e.g., JED, CAI, LHR) |
| return_date | string | Return date in YYYY-MM-DD format. Omit for one-way search |
| nonstop_only | string | Set to 'true' to show only nonstop flights |
| departure_daterequired | string | Departure date in YYYY-MM-DD format |
| refundable_only | string | Set to 'true' to show only refundable fares |
{
"type": "object",
"fields": {
"search": "object containing search parameters summary (origin, destination, departure_date, return_date, cabin, passengers, currency, trip_type)",
"flights": "array of flight objects with id, airline, flight_codes, price, duration_minutes, total_stops, baggage, seats_available, has_fare_families",
"total_results": "integer count of flights returned",
"airlines_found": "array of unique airline IATA codes in results"
},
"sample": {
"data": {
"search": {
"cabin": "Economy",
"origin": "RUH",
"currency": "USD",
"trip_type": "oneway",
"passengers": {
"adults": 1,
"infants": 0,
"children": 0
},
"destination": "JED",
"return_date": null,
"departure_date": "2026-05-10"
},
"flights": [
{
"id": "3595bab7F3-223d15d4_F3_ONE",
"path": [
"F3-139"
],
"cabin": "Economy",
"price": {
"tax": 0,
"base": 106.39,
"total": 106.39,
"currency": "USD",
"refundable": false,
"cheapest_roundtrip_total": 0
},
"airline": "F3",
"baggage": {
"cabin": "7 KG",
"checkin": "",
"checkin_weight_kg": null
},
"direction": "",
"total_stops": 0,
"arrival_date": "",
"flight_codes": [
"F3-139"
],
"total_layover": "",
"departure_date": "",
"seats_available": 36,
"duration_minutes": 105,
"has_fare_families": true,
"distribution_channel": "DRT"
}
],
"total_results": 139,
"airlines_found": [
"SV",
"XY",
"EK",
"F3"
]
},
"status": "success"
}
}About the almosafer.com API
The Almosafer API provides 3 endpoints for querying flight data from almosafer.com, covering one-way and round-trip itinerary search, date-range fare calendars, and IATA code lookups. The search_flights endpoint returns per-itinerary fields including price, duration, stop count, baggage allowance, and seat availability across Economy, Business, and First cabin classes in any supported currency.
Flight Search
The search_flights endpoint accepts a required origin and destination as IATA codes and a departure_date, with optional filters for cabin, airlines (comma-separated IATA codes), stops, and price range. Results are returned as an array of flight objects, each containing id, airline, flight_codes, price, duration_minutes, total_stops, baggage, seats_available, and a has_fare_flexibility flag. The sort_by parameter accepts price, duration, or stops. The airlines_found array in the response lets you see which carriers are present in the result set without scanning individual records.
Fare Calendar
The get_fares_calendar endpoint returns the cheapest one-way price for each date in a specified range between an origin and destination. The range is defined by departure_from and departure_to in YYYY-MM-DD format; ranges wider than 7 days are automatically broken into multiple requests and merged. Each entry in the fares array includes departure_date, price, airline, currency, and source. A top-level cheapest object surfaces the lowest-priced fare in the range without requiring client-side iteration.
Airport and Airline Lookup
The get_airport_info endpoint resolves one or more IATA codes — airports and airlines can be mixed in a single comma-separated codes parameter. Airport objects return code, name, city, country, and country_code. Airline objects return code and name. This is useful for displaying human-readable labels when building UIs on top of the search or calendar endpoints, which return raw IATA codes throughout.
- Build a flexible date tool that shows the cheapest flight for each day in a month using
get_fares_calendar - Compare prices across airlines on a route by filtering
search_flightswith specificairlinescodes - Display route summaries with full airport names by resolving IATA codes via
get_airport_info - Find the shortest-duration itinerary on a route by setting
sort_by=durationinsearch_flights - Monitor seat availability and prices on specific flights using
seats_availablefrom search results - Identify which carriers serve a given route by reading the
airlines_foundfield from a flight search - Resolve a mixed list of airline and airport IATA codes to display names in a travel dashboard
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Almosafer have an official public developer API?+
What does `search_flights` return beyond the ticket price?+
duration_minutes, total_stops, flight_codes, baggage allowance details, seats_available (a count or flag), and has_fare_flexibility. The top-level response also contains airlines_found — the distinct set of airline codes that appear in the result set — and total_results for the unfiltered count.How does the fare calendar handle wide date ranges?+
departure_from/departure_to range wider than 7 days, the API automatically chunks the range into sequential 7-day windows, fetches each, and merges the results into a single fares array. The total_combinations field tells you how many distinct dates have fare data in the final merged response.Does the API return hotel or car rental data from Almosafer?+
Can I get historical fare data or price trend charts across multiple months?+
get_fares_calendar endpoint returns current lowest fares for future dates in a given range; it does not expose historical pricing or past fare trends. You can fork this API on Parse and revise it to add a historical data endpoint if that data becomes accessible through the source.