{
"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/14043/crude+oil+inventory+fetcher+api/34153/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/14043/crude+oil+inventory+fetcher+api/34154/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/14043/crude+oil+inventory+fetcher+api/34156/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/14043/crude+oil+inventory+fetcher+api/34157/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/14043/crude+oil+inventory+fetcher+api/34158/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/14043/crude+oil+inventory+fetcher+api/34159/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 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 de Obtención de Inventarios de Petróleo Crudo devuelve los stocks de petróleo crudo cerrados por país y por centro de almacenamiento en Estados Unidos. Los valores están en miles de barriles. La cobertura incluye países que reportan stocks y centros como Cushing, Oklahoma, la Reserva Estratégica de Petróleo y las cinco regiones PADD. El código de materia prima en vivo es crude_oil. Utilice List Commodities para leer el catálogo, Get Commodity para el perfil y el inicio de la historia, List Commodity Areas para los códigos de país y centro, Latest Inventory para el nivel actual de cada área, Inventory Time Series para la historia y Inventory Changes para el cambio respecto al período anterior. Filtre una serie o un cambio con códigos de área como US, JP o US-CUSHING. El trigo, el maíz, el gas natural, el litio y el cobre están listados como se planeó, y las llamadas de inventario para esos códigos devuelven no disponible hasta que se activen.
Mil barriles Respuestas de inventario incluyen unidad establecida en mil_barriles Obtener Materia prima devuelve la misma unidad en el perfil de materia prima
Cierre de existencias de 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 respecto al período anterior y el cambio porcentual
Países que informan sobre existencias más los centros de Estados Unidos. Los centros incluyen Cushing en Oklahoma la Reserva Estratégica de Petróleo y las regiones PADD 1 a 5. Los códigos de área son como US JP y US-CUSHING
Pase la materia prima crude_oil y el área US-CUSHING a Último Inventario, Series Temporales de Inventario o Cambios en el Inventario. US-CUSHING es el código del centro para Cushing, Oklahoma
Obtener historial de devoluciones de mercancías desde. Para el petróleo crudo esa fecha es 1982-08-20 en la serie de 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á en vivo El trigo el maíz el gas natural el litio y el cobre están en el catálogo con estado planeado Una llamada de inventario para un código planeado devuelve no disponible hasta que esa mercancía esté en vivo
Cada punto final devuelve datos específicos sobre inventarios de petróleo crudo Por ejemplo Último Inventario proporciona niveles de stock actuales Serie Temporal de Inventarios ofrece datos históricos y Cambios en Inventarios muestra variaciones de stock a lo largo de períodos Cada respuesta incluye métricas relevantes como área período y valor en mil barriles
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), "cambio" (cambio en las existencias) y "fiabilidad" (fiabilidad de la fuente de datos) Estos campos ayudan a los usuarios a entender el estado y las tendencias del inventario
Los datos de respuesta están estructurados en formato JSON, con un objeto principal que contiene arrays de "comercio" y "datos". Cada entrada de "datos" incluye campos relevantes como área, nombre y valores de inventario. Esta organización permite un fácil análisis y parseo de la información del inventario
Los parámetros varían según el punto final. Por ejemplo, Último Inventario acepta códigos de área (por ejemplo, US-CUSHING) para especificar ubicaciones. La Serie Temporal de Inventario permite a los usuarios establecer rangos de fechas con parámetros de "desde" y "hasta". Los usuarios pueden personalizar las solicitudes según sus necesidades de datos
Cada punto final proporciona información distinta: Listar Commodities muestra los commodities disponibles, Obtener detalles del Commodity el perfil del petróleo crudo, Listar Áreas de Commodity enumera países y centros, Inventario más reciente da los niveles de stock actuales, Serie temporal de Inventario ofrece datos históricos, y Cambios en el Inventario muestra variaciones de stock
La precisión de los datos se mantiene a través de actualizaciones regulares de fuentes fiables incluyendo informes gubernamentales y publicaciones de la industria Cada respuesta incluye un campo de "fiabilidad" que indica la credibilidad de la fuente asegurando que los usuarios puedan evaluar la calidad de los datos proporcionados
Los casos de uso típicos incluyen el análisis de mercado las decisiones de inversión y la gestión de la cadena de suministro Los analistas utilizan los datos para rastrear las tendencias de inventario prever los movimientos del mercado y evaluar el impacto de los cambios en el inventario sobre los precios del petróleo crudo
Los usuarios pueden analizar los datos para identificar tendencias comparar los niveles de inventario en las regiones y evaluar los cambios a lo largo del tiempo Al aprovechar los campos "cambio" y "cambio_pct" los usuarios pueden evaluar la importancia de las fluctuaciones de inventario y tomar decisiones informadas basadas en las condiciones del mercado