Public data · v1.3.0

EmptyJet Datasets

Public EmptyJet research and encyclopedia data as JSON — the same published material you see on the site. Free to read and cite; nothing here can be changed through the API.

For tools and scripts (raw JSON): /ai/v1/openapi.json · /ai/v1/datasets

01

How this works

Citeable EmptyJet data for researchers, analysts, and tools — not a booking or charter API.

  1. Read only. You can fetch data. There are no writes and no API keys to manage.
  2. Same as the website. If it is not published on EmptyJet, it is not available here.
  3. Rate limited. Fair use per IP. Heavy automated scraping may receive HTTP 429 with a Retry-After header.
  4. MCP not available yet. JSON endpoints ship first and must stay stable before an MCP server is offered.
  5. People and tools. Use the API reference and catalog pages to browse. Tools should call the raw /ai/v1/* URLs — browsers show plain JSON on purpose.

02

Stable endpoints

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

  1. /ai/v1/openapi.jsonFiltered OpenAPI (AI Public tag only)
    Open referenceRaw JSON
  2. /ai/v1/datasetsCatalog: months, encyclopedia indexes, access policy
    Browse catalogRaw JSON
  3. /ai/v1/research/empty-leg-indexList publishable Empty Leg Index months
    Raw JSON
  4. /ai/v1/research/empty-leg-index/{YYYY-MM}Month summary JSON (gated snapshot)
    templated path
  5. /ai/v1/encyclopedia/aircraftsAircraft encyclopedia index (paginated)
    HTML hubRaw JSON
  6. /ai/v1/encyclopedia/aircrafts/{slug}Aircraft detail JSON — specs, editorial, market prose, FAQ
    templated path
  7. /ai/v1/encyclopedia/airportsAirport index (paginated; ?hubs_only=true for top hubs)
    HTML hubRaw JSON
  8. /ai/v1/encyclopedia/airports/{slug}Airport detail JSON — lede, FAQ, hub demand copy
    templated path
  9. /ai/v1/encyclopedia/compareAircraft comparison index
    HTML hubRaw JSON
  10. /ai/v1/encyclopedia/knowledgeGuides / FAQ / Academy index
    HTML hubRaw JSON

03

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'

04

Research months (live)

Empty Leg Index — cite methodology with every Index citation.

05

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 →692compareOpen encyclopedia →19knowledgeOpen encyclopedia →

06

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": 692,
    "knowledge": 19
  },
  "research_months": [
    "2026-08",
    "2026-09",
    "2026-10",
    "2026-11",
    "2026-12",
    "2027-01",
    "2027-02",
    "2027-03"
  ]
}

07

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.