{
"data": [
{
"commodity": "crude_oil",
"group": "energy",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"coverage": "countries with available stocks + US hubs",
"status": "live",
"last_updated": "2026-08-21"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14040/crude+oil+inventory+data+extractor+api/34132/list+commodities?group=energy&status=live' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"group": "energy",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"history_from": "1982-08-20",
"last_updated": "2026-08-21",
"coverage": "countries with available stocks + US hubs",
"areas_count": {
"countries": 35,
"hubs": 7
}
}
curl --location --request GET 'https://zylalabs.com/api/14040/crude+oil+inventory+data+extractor+api/34134/get+commodity&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"data": [
{
"area": "AT",
"name": "Austria",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "AU",
"name": "Australia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "BE",
"name": "Belgium",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "CA",
"name": "Canada",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "CH",
"name": "Switzerland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "CL",
"name": "Chile",
"type": "country",
"latest": "2026-05-01"
},
{
"area": "CZ",
"name": "Czech Republic",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "DE",
"name": "Germany",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "DK",
"name": "Denmark",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "EE",
"name": "Estonia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "ES",
"name": "Spain",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "FI",
"name": "Finland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "FR",
"name": "France",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "GB",
"name": "United Kingdom",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "GR",
"name": "Greece",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "HU",
"name": "Hungary",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "IE",
"name": "Ireland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "IS",
"name": "Iceland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "IT",
"name": "Italy",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "JP",
"name": "Japan",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "KR",
"name": "South Korea",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "LT",
"name": "Lithuania",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "LU",
"name": "Luxembourg",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "LV",
"name": "Latvia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "MX",
"name": "Mexico",
"type": "country",
"latest": "2025-02-01"
},
{
"area": "NL",
"name": "Netherlands",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "NO",
"name": "Norway",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "NZ",
"name": "New Zealand",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "PL",
"name": "Poland",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "PT",
"name": "Portugal",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "SE",
"name": "Sweden",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "SI",
"name": "Slovenia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "SK",
"name": "Slovakia",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "TR",
"name": "Turkey",
"type": "country",
"latest": "2026-06-01"
},
{
"area": "US",
"name": "United States",
"type": "country",
"latest": "2026-08-21"
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14040/crude+oil+inventory+data+extractor+api/34135/list+commodity+areas?type=country&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"as_of": "2026-08-21",
"data": [
{
"area": "US-SPR",
"name": "Strategic Petroleum Reserve",
"period": "2026-08-21",
"value": 289726,
"reliability": "reported"
},
{
"area": "US-PADD3",
"name": "PADD 3 - Gulf Coast",
"period": "2026-08-21",
"value": 251424,
"reliability": "reported"
},
{
"area": "US-PADD2",
"name": "PADD 2 - Midwest",
"period": "2026-08-21",
"value": 101195,
"reliability": "reported"
},
{
"area": "US-PADD5",
"name": "PADD 5 - West Coast",
"period": "2026-08-21",
"value": 45343,
"reliability": "reported"
},
{
"area": "US-PADD4",
"name": "PADD 4 - Rocky Mountain",
"period": "2026-08-21",
"value": 22524,
"reliability": "reported"
},
{
"area": "US-CUSHING",
"name": "Cushing, OK",
"period": "2026-08-21",
"value": 22428,
"reliability": "reported"
},
{
"area": "US-PADD1",
"name": "PADD 1 - East Coast",
"period": "2026-08-21",
"value": 8423,
"reliability": "reported"
}
],
"meta": {
"count": 7,
"period_min": "2026-08-21",
"period_max": "2026-08-21"
}
}
curl --location --request GET 'https://zylalabs.com/api/14040/crude+oil+inventory+data+extractor+api/34137/latest+inventory?type=hub&sort=value_desc&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"metric": "closing_stocks",
"unit": "thousand_barrels",
"as_of": "2026-08-21",
"data": [
{
"area": "US",
"period": "2026-08-21",
"value": 428910,
"reliability": "reported"
},
{
"area": "US-CUSHING",
"period": "2026-08-21",
"value": 22428,
"reliability": "reported"
}
],
"meta": {
"count": 2,
"next_cursor": "MjAyNi0wOC0yMXxVUy1DVVNISU5HfDE4OTgy",
"from": "2026-08-01",
"to": "2026-08-21",
"from_defaulted": false
}
}
curl --location --request GET 'https://zylalabs.com/api/14040/crude+oil+inventory+data+extractor+api/34139/inventory+time+series?area=US,US-CUSHING&from=2026-08-01&to=2026-08-21&limit=2&cursor=MjAyNi0wOC0yMXxVUy1DVVNISU5HfDE4OTgy&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"commodity": "crude_oil",
"unit": "thousand_barrels",
"as_of": "2026-08-21",
"data": [
{
"area": "US",
"period": "2026-08-21",
"value": 428910,
"change": 95,
"change_pct": 0.02
},
{
"area": "US-CUSHING",
"period": "2026-08-21",
"value": 22428,
"change": 1176,
"change_pct": 5.53
},
{
"area": "US",
"period": "2026-08-14",
"value": 428815,
"change": 4405,
"change_pct": 1.04
},
{
"area": "US-CUSHING",
"period": "2026-08-14",
"value": 21252,
"change": -1314,
"change_pct": -5.82
},
{
"area": "US",
"period": "2026-08-07",
"value": 424410,
"change": 17423,
"change_pct": 4.28
},
{
"area": "US-CUSHING",
"period": "2026-08-07",
"value": 22566,
"change": 1611,
"change_pct": 7.69
},
{
"area": "US",
"period": "2026-07-31",
"value": 406987,
"change": 2479,
"change_pct": 0.61
},
{
"area": "US-CUSHING",
"period": "2026-07-31",
"value": 20955,
"change": 2356,
"change_pct": 12.67
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14040/crude+oil+inventory+data+extractor+api/34140/inventory+changes?area=US,US-CUSHING&periods=4&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Extractor de datos de inventario de petróleo crudo API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
(Ahorra 2 meses pagando anualmente 🎉)
La API Extractora de Datos de Inventario de Petróleo Crudo retorna los inventarios de petróleo crudo cerrados por país y por hub de almacenamiento de los Estados Unidos. Los valores están en miles de barriles. La cobertura incluye países que reportan inventarios y hubs como Cushing, Oklahoma, la Reserva Estratégica de Petróleo y las cinco regiones PADD. El código de producto en vivo es crude_oil. Usa List Commodities para leer el catálogo, Get Commodity para el perfil y el inicio de la historia, List Commodity Areas para códigos de país y hub, Latest Inventory para el nivel actual de cada área, Inventory Time Series para la historia, e Inventory Changes para el movimiento en comparación con el período anterior. Filtra una serie o un cambio con códigos de área como US, JP o US-CUSHING. El trigo, maíz, gas natural, litio y cobre están listados como planeado, y las llamadas de inventario para esos códigos retornan no disponible hasta que se activen.
Mil barriles Inventario las respuestas incluyen unidad configurada a mil_barriles Obtener Commodity devuelve la misma unidad en el perfil de la materia prima
Cierre de existencias de petróleo crudo por país y por centro de Estados Unidos en miles de barriles Cada fila tiene el área el período y el nivel de existencias Los cambios en el inventario también devuelven el cambio con respecto al período anterior y el cambio porcentual
Países que reportan existencias más centros de Estados Unidos Los centros incluyen Cushing Oklahoma la Reserva Estratégica de Petróleo y las regiones PADD 1 a 5 Los códigos de área se ven como US JP y US-CUSHING
Pase la materia prima petróleo_crudo y el área US-CUSHING a Inventario más reciente, Series de tiempo de inventario o Cambios en el inventario. US-CUSHING es el código del centro para Cushing, Oklahoma
Obtener historial de retornos de mercancías desde. Para el petróleo crudo esa fecha es 1982-08-20 en la serie de los Estados Unidos. Otros países comienzan en el primer período que existe para esa área. Establecer desde en la Serie Temporal de Inventario para elegir la fecha de inicio
El_petróleo_crudo está activo El trigo el maíz el gas natural el litio y el cobre están en el catálogo con estado planificado Una llamada de inventario para un código planificado devuelve no disponible hasta que esa mercancía esté activa
Cada punto final devuelve datos específicos sobre inventarios de crudo. Por ejemplo, Último Inventario proporciona niveles de stock actuales, Serie Temporal de Inventarios ofrece datos históricos y Cambios en el Inventario muestra las variaciones de stock a lo largo del tiempo. Cada respuesta incluye detalles relevantes como códigos de área, valores y períodos
Los campos clave incluyen "área" (código de ubicación), "nombre" (nombre de la ubicación), "período" (fecha de los datos), "valor" (nivel de existencias en miles de barriles) y "fiabilidad" (fiabilidad de la fuente de datos) Estos campos ayudan a los usuarios a entender el contexto y la precisión de los datos
Los datos de respuesta están estructurados en formato JSON, con un objeto principal que contiene arreglos de "commodity" y "data". Cada entrada de "data" incluye campos específicos relevantes para el inventario, como área, valor y período, lo que permite un fácil análisis y procesamiento
Los parámetros varían según el punto final Por ejemplo Último Inventario acepta códigos de área para especificar ubicaciones mientras que Inventario Serie Temporal permite a los usuarios establecer rangos de fechas utilizando parámetros de "desde" y "hasta" Los usuarios pueden filtrar datos en función de países o centros específicos
Cada punto final proporciona información distinta: Listar Productos muestra los productos disponibles, Obtener Detalles del Producto el perfil del petróleo crudo, Listar Áreas de Productos enumera países y centros, Último Inventario da los niveles de stock actuales, Series Temporales de Inventario ofrece datos históricos y Cambios en el Inventario muestra variaciones de stock
Los usuarios pueden analizar tendencias en las existencias de petróleo crudo comparando valores a lo largo del tiempo utilizando la Serie Temporal de Inventarios y evaluar cambios con los Cambios en Inventarios. La respuesta estructurada permite una fácil integración en herramientas de análisis de datos o aplicaciones para investigación e informes
Los datos se obtienen de países que informan sobre existencias de petróleo crudo y centros de almacenamiento en EE UU Esto incluye informes oficiales y estadísticas de agencias energéticas asegurando un conjunto de datos fiable y completo para los usuarios
Los casos de uso típicos incluyen el análisis de mercado la investigación de tendencias en el suministro de petróleo la gestión de inventarios para empresas de energía y la previsión económica Los analistas pueden aprovechar estos datos para tomar decisiones informadas basadas en los niveles de inventario actuales e históricos