Data API

Search for Data Series

680,000+ economic data series covering China, Japan, Korea, Taiwan, and regional aggregates. Monthly, quarterly, and annual frequencies.
Search by keyword — e.g. CPI, GDP, exports, unemployment. Filter by country or frequency using the dropdowns below.

GET /v3/search?q=CPI&limit=15

Enter a search term and click Search to find data series.

Data: Select a series above

Data will appear here when you select a series.

Getting Started

The East Asia Econ Data API provides programmatic access to 680,000+ economic indicators (monthly, quarterly, and annual) covering China, Japan, Korea, Taiwan, and regional aggregates. Follow these three steps to start pulling data into your own scripts and models.

Create a free account or subscribe to a paid tier for higher limits. All members get an API key.

Get Your API Key

Visit the API Keys page while signed in. Your personal key (starting with eae_) will be generated automatically. Copy it and keep it private.

Make Requests

Pass your key in the X-API-Key header. Search is open to everyone; data download requires authentication.

Rate Limits

Membership Tier	Monthly Limit	Best For
Free	10 series lookups	Trying out the API
Daily	30 series lookups	Regular monitoring
Daily + Data / East Asia	Unlimited	Research and modelling

Usage resets on the 1st of each month (UTC). You can check your current usage on the API Keys page or via the GET /usage endpoint.

API Endpoints

Endpoint	Auth?	Description
`GET /v3/search?q=...&freq=m`	No	Search for series by keyword. Returns name, country, and available frequencies (m, q, a).
`GET /v3/series/{name}?freq=m`	Yes	Download data for a series. Specify `freq` (m, q, a); defaults to monthly. Optional `start` and `end` date filters.
`GET /v3/info/{name}`	No	Get metadata (available frequencies, date ranges, obs counts) without downloading data.
`GET /v3/stats`	No	Summary statistics: total series, breakdowns by country and frequency.
`GET /usage`	Yes	Your current usage and rate limit status.

Base URL: https://data-api.eastasiaecon.com

Python Example

Copy the script below and replace YOUR_KEY_HERE with the key from your API Keys page. Requires only the requests library (pip install requests).

import requests

API_KEY = "YOUR_KEY_HERE"
BASE    = "https://data-api.eastasiaecon.com"

# ── 1. Search for series ──────────────────────────────────
results = requests.get(f"{BASE}/v3/search", params={
    "q": "CPI",
    "country": "jp",
    "limit": 5
}).json()

print(f"Found {results['count']} series matching 'CPI' (Japan)\n")
for s in results["results"]:
    freqs = ", ".join(s["frequencies"])
    print(f"  {s['name']}  (available: {freqs})")

# ── 2. Download monthly data for one series ───────────────
series_name = results["results"][0]["name"]
data = requests.get(
    f"{BASE}/v3/series/{series_name}",
    headers={"X-API-Key": API_KEY},
    params={"freq": "m", "start": "2020-01-01"}
).json()

print(f"\n{series_name} (monthly)")
print(f"{data['count']} observations from {data['min_date']} to {data['max_date']}\n")

# ── 3. Convert to pandas DataFrame ───────────────────────
import pandas as pd

df = pd.DataFrame(data["data"])
df["Date"] = pd.to_datetime(df["Date"])
df = df.set_index("Date")

print(df.tail(10))

# ── 4. Check your usage ──────────────────────────────────
usage = requests.get(
    f"{BASE}/usage",
    headers={"X-API-Key": API_KEY}
).json()

u = usage["usage"]
print(f"\nUsage this month: {u['requests_used']} / {u['requests_limit'] or 'unlimited'}")

Authentication

Include your API key in the X-API-Key header on every request that requires authentication:

# Python (requests)
response = requests.get(url, headers={"X-API-Key": "eae_your_key_here"})

# curl
curl -H "X-API-Key: eae_your_key_here" "https://data-api.eastasiaecon.com/v3/series/Japan,%20CPI,%20Crude%20oil,%20JPY?freq=m"

# JavaScript (fetch)
fetch(url, { headers: { "X-API-Key": "eae_your_key_here" } })

If your key is compromised, visit the API Keys page and click Regenerate Key. Your old key will stop working immediately.

Response Format

All endpoints return JSON. A typical data response from /v3/series/:

{
  "series_name": "Japan, CPI, Crude oil, JPY",
  "country": "jp",
  "frequency": "m",
  "count": 784,
  "min_date": "1960-01-01",
  "max_date": "2025-04-01",
  "data": [
    {"Date": "2024-01-01", "value": 12082.85},
    {"Date": "2024-02-01", "value": 11934.33},
    ...
  ],
  "rate_limit": {
    "used": 3,
    "limit": null,
    "remaining": null,
    "tier": "premium",
    "period": "monthly",
    "month": "2026-01"
  }
}