Skip to main content

For developers, journalists & AI agents

eSIM Data API & AI Access

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.

No API key JSON + CSV Weekly re-check CC BY 4.0 dataset

MCP server for AI agents

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

7 public endpoints

GET /api/countries

Directory of every destination country with live plan counts and cheapest "from" price.

Query params: currency
GET /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
GET /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
GET /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
GET /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
GET /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
GET /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

Try it now

curl
curl "https://esimadvice.com/api/countries/japan/plans?limit=5&sort=cheapest&currency=USD"
JavaScript
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);
}
Response shape (truncated, illustrative values)
{
  "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

The Global eSIM Data Price Index

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

Files for AI agents and crawlers

Everything an AI agent or crawler needs to understand this site:

Every comparison page also ships JSON-LD (Product, FAQPage, HowTo, Dataset, BreadcrumbList) generated from the same data as the visible content.

No code needed

Show eSIM prices on your own site

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.

HTML snippet
<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

Free with attribution

  • Free for commercial and non-commercial use — no key, no signup.
  • Not a developer? Use the embed snippet above: paste it once and it keeps showing current prices.
  • Republishing our data (articles, apps, datasets) requires visible attribution with a link to esimadvice.com.
  • Every provider’s prices are re-checked weekly; always confirm at the provider checkout — see how we compare plans.
  • Don’t hammer the endpoints; cache on your side and use the CSV for bulk work.
  • Questions, higher-volume needs, or press inquiries: contact the editorial team.
Ask AI