Public data · v1.3.0

EmptyJet Datasets

Read-only JSON for agents and researchers — the same publication gates as Research and encyclopedia pages. Live contracts only. No empty theater.

API reference Browse catalog Methodology

Machine URLs (raw JSON by design): /ai/v1/openapi.json · /ai/v1/datasets

How this surface works

Built for AI agents and analysts who need citeable, gated EmptyJet data — not a booking API.

  • GET only. No writes, no auth tokens to leak, nothing mutable.
  • Same gates as SSR. If it is not publishable on the site, it is not here.
  • Rate limited. Fair use per IP; heavy scrapes get 429 with Retry-After.
  • MCP not offered yet. Contracts must stay stable before an MCP server ships.
  • Humans vs machines. Use API reference / catalog pages to read. Raw /ai/v1/* URLs are for agents — browsers show plain JSON on purpose.

Stable endpoints

Machine contract under /ai/v1. Human docs live at /datasets.

  • /ai/v1/openapi.jsonOpen referenceRaw JSON
    Filtered OpenAPI (AI Public tag only)
  • /ai/v1/datasetsBrowse catalogRaw JSON
    Catalog: months, encyclopedia indexes, access policy
  • /ai/v1/research/empty-leg-indexRaw JSON
    List publishable Empty Leg Index months
  • /ai/v1/research/empty-leg-index/{YYYY-MM}templated path
    Month summary JSON (gated snapshot)
  • /ai/v1/encyclopedia/aircraftsHTML hubRaw JSON
    Aircraft encyclopedia index (paginated)
  • /ai/v1/encyclopedia/aircrafts/{slug}templated path
    Aircraft detail JSON — specs, editorial, market prose, FAQ
  • /ai/v1/encyclopedia/airportsHTML hubRaw JSON
    Airport index (paginated; ?hubs_only=true for top hubs)
  • /ai/v1/encyclopedia/airports/{slug}templated path
    Airport detail JSON — lede, FAQ, hub demand copy
  • /ai/v1/encyclopedia/compareHTML hubRaw JSON
    Aircraft comparison index
  • /ai/v1/encyclopedia/knowledgeHTML hubRaw JSON
    Guides / FAQ / Academy index

Example requests

Copy-paste starters for agents and notebooks.

curl -sS '/ai/v1/datasets'
curl -sS '/ai/v1/research/empty-leg-index/2026-07'
curl -sS '/ai/v1/encyclopedia/aircrafts?limit=100&offset=0'
curl -sS '/ai/v1/encyclopedia/aircrafts/airbus-a319cj'
curl -sS '/ai/v1/encyclopedia/airports?limit=100&offset=0'
curl -sS '/ai/v1/encyclopedia/airports?hubs_only=true&limit=50'
curl -sS '/ai/v1/encyclopedia/airports/klas'

Research months (live)

Empty Leg Index — cite methodology with every Index citation.

Encyclopedia indexes (live)

HTML hubs for people; paginated JSON indexes for agents under /ai/v1/encyclopedia/…. Aircraft and airport detail records include citeable prose (market activity / demand copy), FAQ, and specs.

247aircraftsOpen encyclopedia →38,781airportsOpen encyclopedia →699compareOpen encyclopedia →19knowledgeOpen encyclopedia →

Catalog snapshot

Shape of the catalog. Full live preview: Browse catalog · machine URL /ai/v1/datasets.

{
  "version": "1.3.0",
  "docs": "https://emptyjet.com/datasets",
  "openapi": "https://emptyjet.com/ai/v1/openapi.json",
  "mcp": {
    "status": "not_offered",
    "reason": "Public JSON contracts must remain stable before MCP is published."
  },
  "access": {
    "methods": [
      "GET"
    ],
    "auth": "none",
    "write": false,
    "rate_limited": true
  },
  "encyclopedia_counts": {
    "aircrafts": 247,
    "airports": 38781,
    "compare": 699,
    "knowledge": 19
  },
  "research_months": [
    "2026-07",
    "2026-08",
    "2026-09",
    "2026-10",
    "2026-11",
    "2026-12",
    "2027-01"
  ]
}

API status

Version
1.3.0
Methods
GET
Auth
none
Writes
disabled
Rate limits
on
MCP
not_offered — Public JSON contracts must remain stable before MCP is published.