Skip to main content
Watch a specific route and date pair over time so an agent can act when the fare drops. Use it for prompts like “alert me when Paris to New York for June 17 to 26 goes under €400”. Each response includes the current cheapest cached fare and an offer token you can pass to flight_search when the user decides to book. Cache-only; never triggers a live call.

​
Usage

jinko price-monitoring [options]

​
Options

FlagRequiredDescriptionDefault
--origin <code>Yesorigin IATA code (e.g. PAR for city, CDG for airport). JSON: origin.
--destination <code>Yesdestination IATA code (e.g. NYC for city, JFK for airport). JSON: destination.
--origin-type <type>Noorigin code type: city or airport (default: city). JSON: origin_type."city"
--destination-type <type>Nodestination code type: city or airport (default: city). JSON: destination_type."city"
--departure-date <date>Yesdeparture date (YYYY-MM-DD). JSON: departure_date.
--return-date <date>Noreturn date for round-trip (YYYY-MM-DD). JSON: return_date.
--adults <n>Nonumber of adult passengers (default: 1). JSON: adults.
--cabin-class <class>Nocabin class: economy, premium_economy, business, first. JSON: cabin_class.
--direct-onlyNoonly consider direct flights. JSON: direct_only.
--max-price <amount>Noupper bound on total fare. JSON: max_price.
--include-carriers <codes...>Nowhitelist IATA 2-letter carrier codes (e.g. AF KL). JSON: include_carriers.
--exclude-carriers <codes...>Noblacklist IATA 2-letter carrier codes (e.g. FR U2). JSON: exclude_carriers.
--from <origin>NoDEPRECATED: use —origin.
--to <destination>NoDEPRECATED: use —destination.
--date <date>NoDEPRECATED: use —departure-date.
--return <date>NoDEPRECATED: use —return-date.
--cabin <class>NoDEPRECATED: use —cabin-class.
--passengers <n>NoDEPRECATED: use —adults.

​
Examples

# Plain poll for the cheapest cached PAR → NYC.
jinko price-monitoring --origin PAR --destination NYC \
  --departure-date 2026-06-17 --return-date 2026-06-26 --format json

# Cron entry — poll every 6 hours, alert on a hit.
# 0 */6 * * *
jinko price-monitoring --origin PAR --destination NYC \
    --departure-date 2026-06-17 --return-date 2026-06-26 \
    --direct-only --cabin-class economy --max-price 800 \
    --format json | jq -e '.status == "ok"' \
  && /usr/local/bin/notify-on-price-drop.sh