Cleartrip Flights

Live Indian domestic flight pricing from Cleartrip — the same job-based /scrape/ contract as Google Flights and MakeMyTrip, selected with "source": "cleartrip". Search, fare families and review detail (fare breakup, cancellation windows, coupons) are all available; round trips come back as one priced combination.

Base URL: https://api.scrapeguys.com · Auth: X-API-Key: fsk_… with the cleartrip scope · See the Overview.

Submit a search

curl -X POST 'https://api.scrapeguys.com/api/v1/flight-scraper/scrape/' \
  -H 'Content-Type: application/json' -H 'X-API-Key: fsk_...' \
  -d '{"origin":"DEL","destination":"BOM","departure_date":"2026-12-25",
       "adults":1,"cabin_class":"economy","currency":"INR",
       "source":"cleartrip"}'
# {"job_id":"7a1c...","status":"pending","poll_url":"/api/v1/flight-scraper/scrape/7a1c.../"}

Poll for results

Poll every 1–2 seconds until status is completed or failed. The envelope is the one every source uses — flights, return_flights, search_context, error, error_category — so an existing parser needs no changes. Cleartrip adds:

{
  "flights": [{
    "airlines": ["SpiceJet"], "carrier_code": "SG", "flight_numbers": ["612"],
    "origin": "DEL", "destination": "BOM",
    "departure_time": "2026-12-25T19:20:00.000+05:30",
    "arrival_time": "2026-12-25T21:40:00.000+05:30",
    "duration": "2h 20m", "stops": 0,
    "price": 7076.0, "total_price": 7076.0, "currency": "INR",
    "bookable": true,
    "segments": [ ... ], "layovers": [ ... ],
    "cleartrip_ids": { "journey": "J1", "travel_option_id": "...", "fare_id": "..." }
  }],
  "return_flights": [],
  "round_trip_combination": null,
  "search_context": {
    "source": "cleartrip", "no_results": false, "trip_type": "one_way",
    "applied_currency": "INR", "stops_filtered_out": 0,
    "include_nearby_airports": false,
    "nearby_airports_hidden": {"onward": {}, "return": {}}
  },
  "error": null, "error_category": ""
}

• price is per adult; total_price is the whole party.
• stops_filtered_out is a count, not a flag: how many bookable options max_stops excluded. 0 with no_results: true means the route genuinely has nothing. Same name and meaning as on MakeMyTrip.
• nearby_airports_hidden says what the nearby-airport rule left out, per direction, as a map of airport code to the number of options hidden — for example {"onward": {"NMI": 34}, "return": {}}. Both maps are empty ({}) when nothing was hidden or when include_nearby_airports is true. A route flown only from a nearby airport reads as that, not as "not sold".
• bookable: false marks an option listed without a sellable fare. It prices as 0 and sorts first under a price sort, so skip it if you pick your own option rather than using the expansions.
• cleartrip_ids is what the expansions need. You never send it — they take an index.

An empty route is not an error

A route Cleartrip does not sell comes back status: "completed", error: null and search_context.no_results: true. Check no_results, not error. This includes an origin or destination airport code Cleartrip does not recognise: the job completes with no_results: true, stops_filtered_out: 0 and search_context.unknown_airports listing the offending code(s), rather than failing or being retried.

Batch scraping

POST /api/v1/flight-scraper/batch/ and /batch/results/ accept "source": "cleartrip" with the same rules as /scrape/.

Round trips — one combination, not two legs

One search returns both directions: flights is outbound, return_flights is inbound, and round_trip_combination names the pair Cleartrip itself priced:

"round_trip_combination": {
  "onward_index": 0, "return_index": 2,
  "onward_fare_id": "...", "return_fare_id": "...",
  "price": 11480.0, "currency": "INR",
  "priced_as_pair": true
}

• priced_as_pair: true — the combination came from Cleartrip's own round-trip fare map.
• priced_as_pair: false — no priced combination matched. price and both *_fare_id fields are null; none is invented. The pair is still named by onward_index / return_index, each leg's own fare is on its row, and fare families quotes the real pair.

Do not add the two legs' price values and expect the combination price, and do not split the combination price back across the legs — which is why per_leg_fares is refused. Round-trip responses are also considerably larger than one-way ones.

Expansion endpoints

The search context and its TTL

Expansions resume the search funnel using values stored on the job, so you never pass them — but they expire (30 minutes by default). Past that the expansion is refused before any request is made, with error_category: "invalid_input":

{"error": "the Cleartrip search context for this job is 90 minutes old and the limit is 30; re-run the search and expand a row from the new result",
 "error_category": "invalid_input"}

Retrying cannot help; re-run the search and expand a row from the new result.

Fare families

curl -X POST 'https://api.scrapeguys.com/api/v1/flight-scraper/scrape/fares/' \
  -H 'Content-Type: application/json' -H 'X-API-Key: fsk_...' \
  -d '{"job_id":"7a1c...","flight_index":0,"source":"cleartrip"}'
# 202, then poll the returned job

Fare families list the searched cabin first, so an economy search leads with economy fares.

Review

POST /scrape/review/ returns the fare breakup, cancellation windows and the list of applicable coupons for one itinerary. Same request shape as fares: job_id, flight_index, "source": "cleartrip".

What a review returns

The job's result.review carries:

• price_breakup — rows (label and amount) and total.
• cancellation_windows — every journey's cancellation windows in one flat list: onward first, then return on a round trip. Each window has journey, from, to (ISO, IST), charge, permitted, refundable and breakup (airline and Cleartrip charges). permitted: false means the action is not allowed in that window; refundable is price_breakup.total minus the charge, 0 when not permitted, and null when the total is unknown.
• date_change_windows — the same shape, for date changes.
• fare_rules — the same windows grouped by journey (onward / return).
• coupons — a flat list, one entry per coupon, each tagged applied (true when the booking draft already carries it, false when it is only applicable). The applied coupon carries the discount amount. Empty list when there are none.
• ancillaries and components.

The window lists are empty, never missing, when Cleartrip quotes no rules for the fare or the read failed.

Coupons are listed on the review but not priced: price_coupons is refused on this source.

Errors on this source

The same vocabulary as every other source, so existing dashboards and retry logic work unchanged.

A cabin mismatch is the clearest invalid_search case, and its message names the cabin to search instead:

{"error": "searched ECONOMY but Cleartrip priced only BUSINESS fares for this option. ... search in that cabin instead: cabin_class=business",
 "error_category": "invalid_search"}

Not supported on this source

• Coupon pricing — coupons are listed on review but not applied or compared.
• Calendar / price-per-day — no endpoint exists.
• Currencies and regions other than INR / in.

Next: Google Flights · MakeMyTrip Flights