/api/countries Directory of every destination country with live plan counts and cheapest "from" price.
Query params: currencyFor developers, journalists & AI agents
Free, no-key read access to the data behind eSIM Advice: 205,954 live plans from 96 providers across 215 countries, with prices re-checked weekly. Use it in apps, research, journalism, or AI tools — just attribute us. See how we compare plans.
Connect your agent to https://esimadvice.com/mcp (Model Context Protocol, stateless streamable
HTTP — no key, no signup). Five tools: search_esim_plans, list_countries,
list_providers, get_price_history, get_coupon_codes. Every plan result
includes a working buy link and the coupon already applied — the same plans and the same
free-with-attribution CC BY 4.0 terms as the REST API below.
Endpoints
/api/countries Directory of every destination country with live plan counts and cheapest "from" price.
Query params: currency/api/providers Directory of every eSIM provider with its plan count. isVerified is a listing flag, not a quality rating, and rating is null because we publish no star ratings.
Query params: no parameters/api/countries/{slug}/plans Every live plan for a destination, coupon-applied prices, cheapest-first.
Query params: limit (default 30, ≤100) · sort (cheapest | price-per-gb | most-data | longest-validity) · min_gb · validity (min days) · max_validity (expires within N days; no-expiry plans excluded) · price or max_price (max, in the response currency, against the price shown) · promo=0 (list prices and list-price sort; default 1 = coupon-applied) · provider · hotspot=1 · unlimited=1 · fiveg=1 · coupon=1 · plan_type · hide_dominated=1 (no plan_type: drop multi-country packs the same provider beats with a plan for this country — the All tab) · lang (en | fr | it | zh | es | de: plan titles and labels) · currency · cursor/api/providers/{slug}/plans Every live plan a provider sells, across all destinations.
Query params: limit (default 24, ≤50) · sort (cheapest | price-per-gb | most-data | longest-validity) · currency · cursor/price-index.csv The Global eSIM Data Price Index: every country ranked by real cheapest ≥1GB price. CC BY 4.0.
Query params: no parameters — the latest day’s prices/price-index.json The same Global eSIM Data Price Index as JSON — easier to parse. CC BY 4.0.
Query params: no parameters — the latest day’s prices/freshness.json When each provider’s prices were last checked: date of the last successful check, age in days, check interval and status (current / aging / stale), plus the weekly schedule and the latest Price Index day.
Query params: no parameters /api responses can be up to 15 minutes old (occasionally up to an hour more);
the Price Index CSV and JSON up to six hours. Plan prices themselves are re-checked once a week per
provider — /freshness.json shows the date of each check. If an /api endpoint answers
503, wait the number of seconds in its Retry-After header and repeat the request.
Please keep request rates reasonable — for bulk analysis, the
CSV dataset is the right tool. Country and provider slugs are listed in the
country and provider directories.
Quick start
curl "https://esimadvice.com/api/countries/japan/plans?limit=5&sort=cheapest¤cy=USD" const res = await fetch(
"https://esimadvice.com/api/countries/japan/plans?limit=5&min_gb=3&hotspot=1"
);
const { items, totalMatching } = await res.json();
for (const plan of items) {
console.log(plan.providerName, plan.dataLabel, plan.validityLabel, plan.formattedPrice);
} {
"ok": true,
"country": "france",
"currency": "USD",
"lang": "en",
"promoApplied": true,
"totalMatching": 1829,
"nextCursor": "eyJwIjoiMC45OSIsImkiOjQ4NDg2fQ",
"items": [
{
"id": 48486,
"providerName": "Flysimio",
"providerSlug": "flysimio",
"planName": "France · 500 MB · 1 day · 5G",
"merchantPlanName": "France 500MB/Day",
"planType": "local",
"dataGb": 0.5,
"dataLabel": "500 MB",
"isUnlimited": false,
"validityDays": 1,
"validityLabel": "1 day",
"priceUsd": 0.9,
"basePriceUsd": 1.0,
"priceValue": 0.9,
"formattedPrice": "$0.90",
"formattedOriginalPrice": "$1.00",
"pricePerGbLabel": "$1.80/GB",
"hasCoupon": true,
"networkType": "5G",
"hotspotAllowed": true,
"comboHref": "/esim/france/flysimio",
"buyHref": "/go/48486"
}
]
} Dataset
Every country ranked by what 1GB of travel data really costs, from prices we re-check weekly, with per-country provider counts, unlimited pricing, and best price/GB. Licensed CC BY 4.0: free to publish, chart, and cite with attribution to "eSIM Advice — Global eSIM Data Price Index (esimadvice.com/price-index)".
For AI agents
Everything an AI agent or crawler needs to understand this site:
/llms.txt Concise site guide for LLMs and AI agents /llms-full.txt Extended machine-readable inventory: pages, tools, API, dataset, citation policy /openapi.json OpenAPI 3.1 spec for the endpoints on this page /mcp MCP server for AI agents — live plans, prices, history and coupons as callable tools /sitemap.xml Sitemap index — every indexable page, by section /.well-known/security.txt RFC 9116 security contact /price-index Human-readable Price Index with Dataset JSON-LD markup Every comparison page also ships JSON-LD (Product, FAQPage, HowTo, Dataset, BreadcrumbList) generated from the same data as the visible content.
No code needed
Writing about a destination? Paste this snippet into your page and it shows the three cheapest plans for that country, with coupons already applied. We re-check prices weekly, so the box keeps itself current. It is free to use as long as the credit link stays in place.
<iframe src="https://esimadvice.com/embed/country/japan" width="100%" height="340" style="max-width:420px;border:0" loading="lazy" title="Cheapest Japan eSIM plans"></iframe>
<p style="font-size:12px;margin:4px 0 0"><a href="https://esimadvice.com/esim/japan?utm_source=widget" target="_blank" rel="noopener">Live Japan eSIM prices by eSIM Advice</a></p>
Type the country as it is written in its address on this site — /esim/japan,
/esim/united-states — and the snippet and the preview change with it.
Terms