Open data and AI access

Every figure on this site is also published as data: the same numbers, read by the same code, each with the day it was read and the search behind it. You may reuse them under CC BY 4.0, with a link back.

Use the files
Connect an assistant
What the figures mean
Cite a figure

The files

/api/v1/index.json: the catalogue, with every file, the vocabulary and the rules.
/api/v1/destinations.json: the ranking, one row per destination, in the order of the table on our home page.
/api/v1/flights.json: every airfare we have read, by family.
/api/v1/sites.json: 87 points along the path, with the totality our oracle computed and the cloud range at each. These are points, not destinations: we priced nothing there.
/api/v1/destinations/<key>.json: everything we hold on one place, listed below.

One file per destination
Place	Key	Data
Cádiz	`cadiz`	JSON for Cádiz
Chefchaouen	`chefchaouen`	JSON for Chefchaouen
Djerba (no page yet)	`djerba`	JSON for Djerba
Gibraltar	`gibraltar`	JSON for Gibraltar
Jeddah (no page yet)	`jeddah`	JSON for Jeddah
Luxor	`luxor`	JSON for Luxor
Marsa Alam	`marsa-alam`	JSON for Marsa Alam
Mecca	`mecca`	JSON for Mecca
Siwa Oasis (no page yet)	`siwa-oasis`	JSON for Siwa Oasis
Tangier (no page yet)	`tangier`	JSON for Tangier
Tétouan	`tetouan`	JSON for Tétouan

No key and no account, and any website may fetch them. They change when the site does: the prices in them were read on 20 and 24 September 2026. Each file carries schema_version 1.0.0: it changes when a field changes meaning or disappears, never when one is added.

One figure, as the file carries it

The first row of our table is Chefchaouen: €92 for two for the four eclipse nights, read on 24 September 2026 on Booking.com. In destinations.json that row reads:

{
  "key": "chefchaouen",
  "name": "Chefchaouen",
  "rank": 1,
  "page_url": "https://eclipsemission.com/2027/morocco/chefchaouen/",
  "lodging": {
    "stay_for_two_eur": 91.9,
    "per_person_eur": 45.95,
    "currency": "EUR",
    "eclipse_premium": 1.16,
    "platform": "Booking.com",
    "observed_at": "2026-09-24T17:42:19.501Z",
    "source_url": "https://www.booking.com/searchresults.html?ss=Chefchaouen&checkin=2027-07-31&checkout=2027-08-04&group_adults=2&group_children=0&no_rooms=1&selected_currency=EUR&order=price&lang=en-gb"
  }
}

Connect an AI assistant

MCP, the Model Context Protocol, is the standard AI assistants use to call outside tools. Paste this address where your assistant lists MCP servers or connectors. There is nothing to install and no sign-in.

Server address

Transport: Streamable HTTP
Access: read-only, no authentication
Protocol versions: 2025-03-26 to 2026-07-28

Six tools

list_destinations: Where to see the eclipse, in the order of our table. Optional: max_price_per_person_eur, min_totality_seconds, country, open_to_all_visitors.
plan_trip: The places that fit one traveller. Each comes with the entry regime for their passport and the fares we read from their airport, shown next to the stay and never added to it. Optional: origin, passport and the filters of list_destinations.
get_destination: Every figure for one place. destination is a key from the table above; passport, optional, is one of FR, GB, US, CA, SA, AE, MA.
compare_destinations: Two to four places side by side, in the order of our table. destinations is a list of keys; passport is optional.
get_flights: The airfares we have read. Optional: origin, an airport code such as CDG, and destination.
list_eclipse_sites: The 87 points of sites.json. Optional: country, min_totality_seconds, max_cloud_pct, in_path, and sort by totality. It takes no coordinates: a place missing from the list has not been computed.

The server also serves each file above as a resource, plus one prompt, plan_eclipse_trip. It starts a trip plan from an airport, a passport and a budget.

Questions to try

Where can I see the eclipse of 2 August 2027 for under €100 a person, with public transport?
What do four nights in Marsa Alam cost for two during the eclipse, and when was that read?
Do I need a visa for Egypt with a US passport?
Which points in Spain get more than four minutes of totality?

Every answer the server returns carries the reading day of each price and the page to link.

What the figures mean

Every file and every answer carries these rules, because a figure read without them says something else.

Prices and stays

The lodging figure is the mean of the ten cheapest rooms listed for two adults, 31 July to 4 August 2027 (four nights), taxes included, on the platform and the day named. It is never "the cheapest room". A reading with fewer than ten listings is the mean of those listed; sample_size says how many.
per_person_eur is the stay for two divided by two. A solo traveller is a different search, given as solo_traveller where it was measured.
The Eclipse Premium is the eclipse-week mean divided by the same search one week later (7 to 11 August 2027) in the same town. It is never computed across towns.
A cheap stay, on this site, is one at or under 130 EUR for two for the four nights.

The eclipse, the sky and the heat

Totality durations and times come from our oracle, never from a web lookup.
Cloud is a range between two reanalyses, NASA POWER and Copernicus ERA5, never one number: quote both ends. midday_cloud_pct is ERA5 over the hours totality falls in.
Heat is the mean daily maximum over the eclipse fortnight, 2001-2024 (NASA POWER): a proxy for the temperature at totality, not a measurement of it.

Entry, access and flights

Entry regimes are per passport. A passport we did not collect is not answered with another's regime, and a fee is a number only where the issuing authority publishes it.
Access: "Public transport confirmed" means a named operator publishes a timetable we read, today's grid and not a 2027 one; "Stop mapped, service not confirmed" means OpenStreetMap maps a stop and no operator publishes a grid for it.
Flights come in two families that are never added together: Google Flights searches (return trip, two adults, as the search displayed it) and easyJet fares read at the airline (one seat, one way). A route we did not read is absent, which is not a claim that no flight exists.
Mecca is priced but not ranked: entry is restricted to Muslims. It follows the ranking with no rank, as on the site's table, and a sentence about the cheapest place leaves it out.

Dates and reuse

Every figure carries the day it was read, and describes that day. Prices are re-read on a schedule (next_reading).
The data is published under CC BY 4.0. Cite it as cite_as gives it ("EclipseMission, Eclipse Premium Index, measured 20 and 24 September 2026, eclipsemission.com/eclipse-premium/") and link the destination's page_url.

Licence and citation

The data is published under CC BY 4.0. Cite it as:

EclipseMission, Eclipse Premium Index, measured 20 and 24 September 2026, eclipsemission.com/eclipse-premium/

When you write about one place, link its page: the table above gives it, and each file carries it as page_url. Some parts carry an attribution of their own, served next to them: OpenStreetMap contributors (ODbL) for the positions of airports, and NASA POWER, Copernicus ERA5 and EUMETSAT CM SAF for the sky and the heat.

A figure looks wrong? Write to [email protected].

How we measure every figure