Service metadata

Code snippets

curl "https://api.oanor.com/countrystats-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/countrystats-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/countrystats-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/countrystats-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "service": "countrystats-api",
        "endpoints": {
            "GET /v1/list": "List countries (limit, offset, landlocked=true to filter).",
            "GET /v1/meta": "This document.",
            "GET /v1/rank": "Rank countries by a metric (by=population|area_km2|population_density|life_expectancy, order=desc|asc, limit).",
            "GET /v1/search": "Search by country name or government type (q=).",
            "GET /v1/country": "All statistics for a country (country=, e.g. Germany — or code=, e.g. de)."
        },
        "description": "Country statistics: government type, landlocked flag, surface area (km²), population, population density and life expectancy, enriched with ISO 3166-1 alpha-2 code and flag emoji. Look up by country or code, rank by any numeric metric, search or list. Distinct from countries-api (ISO identifiers) and disease-api (health). No key.",
        "total_countries": 250,
        "rankable_metrics": [
            "population",
            "area_km2",
            "population_density",
            "life_expectancy"
        ],
        "landlocked_countries": 43
    },
    "meta": {
        "timestamp": "2026-06-08T18:25:08.844Z",
        "request_id": "ecfe2253-d3a7-4bba-b28f-976ca5151353"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}