EconGE · For machines

Public API, v1

Open access — no key needed to start. Everything the portal shows, as JSON, CSV, TSV, XLSX, or ZIP. Free API keys raise your rate limits five-fold. Datasets have stable slugs that survive archive rebuilds — prefer them over numeric ids.

Rate limits & keys

Anonymous 60 / minute · 600 / hour No signup
Free key 300 / minute · 20,000 / day Instant, below

Get a free key — sent as the X-API-Key header. Shown once; only a hash is stored.

Quick examples

curl https://levanalibegashvili.com/sites/econge/api/v1/sources

curl 'https://levanalibegashvili.com/sites/econge/api/v1/datasets?topic=prices&recent=1'

curl 'https://levanalibegashvili.com/sites/econge/api/v1/observations.xlsx?datasets=51,52&from=2020-01-01' -o bundle.xlsx

Routes

GET /sources sources with stats
GET /topics topics with dataset counts
GET /datasets[.json|.csv|.tsv|.xlsx] paginated catalog with filters
GET /datasets/{id} dataset metadata
GET /datasets/{id}/observations[.json|.csv|.tsv|.xlsx] single dataset observations
GET /observations[.json|.csv|.tsv|.xlsx|.zip] multi-dataset bundle (requires ?datasets=ID1,ID2)

Filters

source=geostat,mof · topic=prices · frequency=annual,monthly facet filters, comma-separated
q=GDP full-text search
recent=1 datasets with observations in the last 90 days
from=2020-01-01 · to=2024-12-31 date range on observations
format=long|wide multi-dataset shape (wide requires same frequency)

Limits

50 datasets max per bundle
500,000 observations max per bundle
1,000 max page_size for JSON pagination; CSV/XLSX/ZIP unpaginated within bundle limits

Errors

All errors are JSON, regardless of requested format. Each carries an error slug for programmatic branching: 

{"error": "too_many_rows", "message": "...", "limit": 500000, "actual": 743219}
Interactive docs — Swagger UI →

Data originates from GeoStat, the National Bank of Georgia, the Ministry of Finance, the IMF, and the World Bank — attribution to the original source is required when you republish it. Each source's license is listed in the sources endpoint's upstream catalog.