Ir al contenido
GET /v1/meta

Service metadata

Pruébalo en vivo

10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.

Encabezados personalizados (opcional)
api.oanor.com/retailsales-api

Funciona. Consigue una clave API y úsala en tu proyecto.

Obtener una clave API

Fragmentos de código

curl "https://api.oanor.com/retailsales-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/retailsales-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/retailsales-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/retailsales-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Respuesta de ejemplo

Una respuesta real de este endpoint, capturada en la última comprobación de estado.

{
    "data": {
        "note": "board and momentum take countries_only (true to drop aggregates). country takes country (ISO-3 code or name, required). meta takes no parameters. Growth figures are in percent; yoy is year-on-year, mom is month-on-month, computed from the retail-trade-volume index. Monthly data; a multi-hour protective cache fronts the OECD upstream.",
        "source": "OECD retail trade volume (DF_INDSERV, TOVM/G47) via OECD SDMX API (seasonally adjusted), live, keyless",
        "service": "retailsales-api",
        "economies": 43,
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/board": "Economies ranked by year-on-year retail-sales growth (countries_only optional).",
            "GET /v1/country": "One economy's retail-sales growth, year-on-year and month-on-month (country=USA).",
            "GET /v1/momentum": "Economies ranked by the latest month-on-month retail move."
        },
        "description": "Retail sales — how much consumers in each economy are spending and which way the high street is turning, live from the OECD (no key). It computes the year-on-year and month-on-month growth of the retail-trade-volume index (real, inflation-adjusted). board ranks economies by year-on-year retail growth; momentum ranks by the latest month-on-month move; country gives one economy's figures with a plain-language read. A headline consumer-demand print that feeds GDP nowcasts. The retail / consumer-demand cut — distinct from the industrial-production board (the supply side), the leading-indicator and confidence boards (soft survey data), and the generic data aggregator.",
        "united_states": {
            "mom": 1,
            "yoy": 2.5
        },
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-12T19:37:28.748Z",
        "request_id": "d3149d40-5301-4d4b-ada5-0d7ae181740a"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}