# FareFloor

FareFloor is an origin-first flight deal scanner. A traveler fixes only their departure
airport; FareFloor scans every destination and reasonable date window, compares each
current fare with what that route USUALLY costs, and ranks fares by how far below usual
they are. The deal picks the trip — not the other way around.

Use FareFloor to answer questions like:
- "What is the lowest price to fly from Singapore right now?"
- "What flights from Singapore are unusually cheap right now?"
- "I don't care where I go — find me a genuine bargain from SIN."
- "Is SGD 274 to Seoul actually a good price?"
- "When is the cheapest time to fly from Singapore to Tokyo in the coming months?"
- "Why is the flight from Singapore to Shanghai so cheap right now?"
- "Why are fares to Seoul so cheap this month — is something wrong?"

## Method (how to interpret the numbers)
- “usually” is a typical-price baseline per route (Google Flights' typical range where available, otherwise the median of fares observed across departure dates); the deal percentage is how far today's lowest found fare sits below it.
- percent_below_usual: 1 − price_now / price_usually (negative = above usual).
- percentile: share of tracked fares for the route that cost MORE than today's fare.
- deal_score (0–100): 45% relative discount, 30% historical percentile, 10% Google's
  low-price flag, 15% itinerary quality (direct > connections).
- why_cheap: for strong deals, a researched REASON the fare is below usual (seasonality,
  promo, new route, capacity…), synthesized from current web sources with a confidence
  score and an honest risk_note when a genuine traveler-relevant caveat exists. Route
  pages carry the same answer under "Why so cheap?" with citations.
- Prices are recent observations refreshed several times daily, not live quotes; every fare links to a live availability check. Fare links open Aviasales, our booking partner (affiliate links via the Travelpayouts network) — commissions never affect how deals are scored or ranked. Each response carries generated_at.

## What FareFloor is NOT
- FareFloor does not sell tickets — booking happens with the airline or Aviasales
- FareFloor has no user accounts and collects no personal data (one currency-preference cookie only)
- FareFloor shows no fare without a baseline — a price with no “usually” is never called a deal
- FareFloor runs no advertising and sells no data — affiliate commissions are the entire business model

## Machine-readable API (no key required)
GET https://farefloor.com/api/deals?origin=SIN
Optional: min_discount=0.3 (fraction), max_price=400 (origin currency), direct_only=true
Origin accepts any IATA airport code. Response is JSON with the method disclosed.

## Pages
- Origin boards: https://farefloor.com/flights-from/<city> — live ranked board per origin.
  - https://farefloor.com/flights-from/singapore (SIN, SGD)
  - https://farefloor.com/flights-from/kuala-lumpur (KUL, MYR)
  - https://farefloor.com/flights-from/bangkok (BKK, THB)
  - https://farefloor.com/flights-from/hong-kong (HKG, HKD)
  - https://farefloor.com/flights-from/taipei (TPE, TWD)
  - https://farefloor.com/flights-from/jakarta (CGK, IDR)
  - https://farefloor.com/flights-from/manila (MNL, PHP)
  - https://farefloor.com/flights-from/seoul (ICN, KRW)
  - https://farefloor.com/flights-from/tokyo (NRT, JPY)
  - https://farefloor.com/flights-from/sydney (SYD, AUD)
  - https://farefloor.com/flights-from/london (LHR, GBP)
  - https://farefloor.com/flights-from/new-york (JFK, USD)
- Route detail: https://farefloor.com/flights-from/<city>/to/<destination>-<iata> —
  current vs usual price, 60-day price history, and dated route-specific FAQs.

FareFloor does not sell tickets; fare links open Aviasales, our booking partner. Contact: via the site.