Airhint CLI

AirHint flight price prediction API — buy/wait recommendations for airline tickets

Learn more at Airhint.

Created by @jvm (jvm).

Quick Start

1. Install

See Install above.

2. Verify Setup

airhint-pp-cli doctor

This checks your configuration.

3. Try Your First Command

airhint-pp-cli airport-autocomplete --query example-value

Unique Features

These capabilities aren't available in any other tool for this API.

Compound query

• workflow predict-sweep — Sweep buy/wait predictions across a date range for a route, fetching live prices for each date

  Enables batch price intelligence for flexible travelers — find the cheapest AND safest date to buy

  airhint-pp-cli workflow predict-sweep STN DUB --days 14 --airline FR --json
  

• workflow compare-routes — Compare buy/wait predictions across multiple origin-destination pairs on the same date

  One command to compare 3+ routes vs 3+ browser tabs — agent-native travel planning

  airhint-pp-cli workflow compare-routes 2026-08-16 STN:DUB LGW:BCN MAD:LIS --json
  

Local state that compounds

• workflow cheapest-window — Find the cheapest departure date in a given month using the cheapest-deal-month and cheapest-airline-deal-month endpoints

  Answers 'what date in August is cheapest for STN→DUB?' without opening the browser

  airhint-pp-cli workflow cheapest-window STN DUB 8 --airline FR
  

Usage

Run airhint-pp-cli --help for the full command reference and flag list.

Commands

airport-autocomplete

Airport and city search autocomplete

• airhint-pp-cli airport-autocomplete - Search airports and cities by name or IATA code

airport-names

Bulk airport name lookup

• airhint-pp-cli airport-names - Get airport names for a list of IATA codes

cheapest-airline-deal-month

Find the cheapest deal for a specific airline in a month

• airhint-pp-cli cheapest-airline-deal-month <airline> <origin> <destination> <date> <currency> - Get cheapest fare for a specific airline on a route near a date

cheapest-deal-month

Find the cheapest flight deal in a given month

• airhint-pp-cli cheapest-deal-month <origin> <destination> <month> - Get the cheapest one-way fare for a route in a given month

flights

Flight search — find available flights and current prices

• airhint-pp-cli flights create-search - Initiate a flight search, returns a search_id for polling
• airhint-pp-cli flights get-search - Poll for search results using the search_id from create_search

predict

Flight price prediction — buy or wait recommendations

• airhint-pp-cli predict <airline> <origin> <destination> <date> - Get buy/wait recommendation for a flight at a given price

Output Formats

# Human-readable table (default in terminal, JSON when piped)
airhint-pp-cli airport-autocomplete --query example-value

# JSON for scripting and agents
airhint-pp-cli airport-autocomplete --query example-value --json

# Filter to specific fields
airhint-pp-cli airport-autocomplete --query example-value --json --select id,name,status

# Dry run — show the request without sending
airhint-pp-cli airport-autocomplete --query example-value --dry-run

# Agent mode — JSON + compact + no prompts in one flag
airhint-pp-cli airport-autocomplete --query example-value --agent

Agent Usage

This CLI is designed for AI agent consumption:

• Non-interactive - never prompts, every input is a flag
• Pipeable - --json output to stdout, errors to stderr
• Filterable - --select id,name returns only fields you need
• Previewable - --dry-run shows the request without sending
• Explicit retries - add --idempotent to create retries when a no-op success is acceptable
• Confirmable - --yes for explicit confirmation of destructive actions
• Piped input - write commands can accept structured input when their help lists --stdin
• Offline-friendly - sync/search commands can use the local SQLite store when available
• Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.

Health Check

airhint-pp-cli doctor

Verifies configuration and connectivity to the API.

Configuration

Config file: ~/.config/airhint-pp-cli/config.toml

Static request headers can be configured under headers; per-command header overrides take precedence.

Troubleshooting

Not found errors (exit code 3)

• Check the resource ID is correct
• Run the list command to see available items

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Discovery Signals

This CLI was generated with browser-captured traffic analysis.

• Target observed: https://region1.analytics.google.com/g/collect
• Capture coverage: 8 API entries from 16 total network entries
• Reachability: browser_http (78% confidence)
• Protocols: rest_json (75% confidence)
• Protection signals: cloudflare (90% confidence)
• Generation hints: browser_http_transport, requires_protected_client, weak_schema_confidence
• Candidate command ideas: create_airport_names — Derived from observed POST /airport-names traffic.; get_DUB — Derived from observed GET /cheapest-deal-month/one-way/STN/DUB/{dub_id} traffic.; get_search — Derived from observed GET /search/{search_id} traffic.; list_2026_08_16 — Derived from observed GET /predict/FR/STN/DUB/2026-08-16 traffic.; list_airport_autocomplete — Derived from observed GET /airport-autocomplete traffic.; list_inline_ads — Derived from observed GET /inline-ads traffic.; list_kayak_location_lookup — Derived from observed GET /kayak-location-lookup traffic.

Warnings from discovery:

• weak_schema_evidence: Binary or protobuf response cannot provide reliable JSON schema evidence.

---

Generated by CLI Printing Press