Public data API

What it is

The same data that builds Lounge Frog and Cruise Frog, as JSON. It is free, needs no key or sign-up, and only reads. It is meant for AI assistants answering travel questions, for researchers, and for anyone building on top of it.

• Base URL: https://lounge-frog-api.onrender.com/public/v1
• Interactive reference: lounge-frog-api.onrender.com/public/docs
• OpenAPI 3.1 document: lounge-frog-api.onrender.com/public/v1/openapi.yaml

Endpoints

Every path below starts with the base URL. All take GET.

• /lounges?airport=JFK&program=priority-pass
  Lounges, filtered by airport, lounge network, airline status or credit card
• /lounges/{slug}
  One lounge: hours, terminal, nearest gate, who gets in, guest policy, ratings
• /airports?has_lounges=true
  Airports with their open lounge count and ratings
• /airports/{code}
  One airport, its terminals and the lounges in each
• /programs?kind=card
  Credit cards, lounge networks and airline status programs, and what each unlocks
• /programs/{slug}
  One program, the cards that include it and how many lounges it opens
• /airlines
  Airlines with hubs, fleet size and ratings
• /airlines/{code}
  One airline, with its safety record and terminals
• /point-values
  What a point or mile in each loyalty program is worth, in US cents
• /cruise-lines
  Cruise lines with fleet counts and fleet ratings
• /cruise-lines/{slug}
  One line, its write-up and its fleet
• /ships?line=royal-caribbean
  Ships, filtered by line, status, region or home port
• /ships/{slug}
  One ship: size, capacity, space ratio, home port, ratings
• /ports
  Cruise home ports, by the airport you fly into
• /ports/{code}
  One port, its guide and the ships based there
• /news?site=cruise
  Original reporting from Lounge Frog, Cruise Frog and Points Frog, newest first

Lists come back a page at a time (limit up to 500, offset), with meta.next pointing at the next page. Records are looked up by slug, or by IATA code for airports, airlines and ports.

What an answer looks like

GET https://lounge-frog-api.onrender.com/public/v1/lounges?airport={code}

{
  "data": [
    {
      "slug": "…",
      "name": "…",
      "status": "open",
      "airport": { "code": "…", "name": "…", "url": "https://www.loungefrog.com/airports/…" },
      "terminal": { "slug": "…", "name": "…", "url": "…" },
      "hours": "…",
      "overall_rating": 0,
      "ratings": { "food": 0, "drinks": 0, "seating": 0 },
      "access": [{ "program": "…", "kind": "lounge", "note": "…", "url": "https://www.loungefrog.com/programs/…" }],
      "verified_on": "YYYY-MM-DD",
      "url": "https://www.loungefrog.com/lounges/…"
    }
  ],
  "meta": { "total": 0, "limit": 100, "offset": 0, "next": null },
  "attribution": { "text": "Lounge Frog (loungefrog.com)", "url": "https://www.loungefrog.com", "terms": "…" }
}

Cite the page, not the API

Every record has a url: the page on Lounge Frog or Cruise Frog where a person can read it. Single-record answers also send it as a Link: rel="canonical" header. When you quote a record, link to that page. It shows the same facts, with photos, sources, and the date they were last checked.

Terms

• Quoting and citing is free, for people and AI assistants alike, as long as you link to the record's page.
• Ratings are our editorial scores from 1 to 5, made as our methodology describes. Lounge access rules are a guide, not a guarantee; lounges change their policies.
• Bulk copying, redistribution or resale of the dataset needs a license. Email founder@loungefrog.com.

Limits and caching

Each client can make 300 requests a minute. The RateLimit-Remaining header says how many are left; past the limit you get a 429 with Retry-After. Answers can be cached for five minutes and carry an ETag, so a repeat request with If-None-Match costs nothing. CORS is open, so a browser can call it from any site.

Fields may be added to v1 but are never renamed or removed. If you need more, a higher limit or a feed of changes, email founder@loungefrog.com.