{
"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/14039/fetch+crude+oil+inventory+data+api/34130/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/14039/fetch+crude+oil+inventory+data+api/34131/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/14039/fetch+crude+oil+inventory+data+api/34133/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/14039/fetch+crude+oil+inventory+data+api/34136/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/14039/fetch+crude+oil+inventory+data+api/34138/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/14039/fetch+crude+oil+inventory+data+api/34141/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 Obtener 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 de Datos de Inventario de Petróleo Crudo Fetch devuelve las existencias de petróleo crudo cerradas por país y por centro de almacenamiento de Estados Unidos. Los valores están en miles de barriles. La cobertura incluye países que informan existencias y centros como Cushing, Oklahoma, la Reserva Estratégica de Petróleo y las cinco regiones PADD. El código de mercancía en vivo es crude_oil. Utilice Listar Mercancías para leer el catálogo, Obtener Mercancía para el perfil y el inicio de la historia, Listar Áreas de Mercancía para códigos de país y centro, Último Inventario para el nivel actual de cada área, Serie Temporal de Inventario para la historia y Cambios en el Inventario para el movimiento en comparación con el 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 está previsto, y las llamadas de inventario para esos códigos no están disponibles hasta que entren en funcionamiento.
Mil barriles Respuestas de inventario incluyen unidad establecida en mil_barriles Obtener Producto devuelve la misma unidad en el perfil del producto
Cierras 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 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 Oklahoma la Reserva Estratégica de Petróleo y las regiones PADD del 1 al 5 Los códigos de área son como US JP y US-CUSHING
Pase la materia prima crudo_petróleo y el área US-CUSHING a Inventario más reciente, Serie temporal de inventario o Cambios en el inventario US-CUSHING es el código de hub para Cushing, Oklahoma
Obtén el historial de retornos de materias primas 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. Establece desde en la serie temporal de inventarios 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 de inventario de petróleo crudo Por ejemplo Último Inventario proporciona niveles de stock actuales Serie Temporal de Inventario ofrece datos históricos y Cambios en el Inventario muestra variaciones de stock a lo largo del tiempo Cada respuesta incluye métricas relevantes y detalles del área
Los campos clave incluyen "área" (código de ubicación), "nombre" (nombre de 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 los niveles de inventario y su contexto
Los datos de respuesta están estructurados en formato JSON con un objeto principal que contiene metadatos y un array de "datos" Cada entrada en el array corresponde a un área específica detallando su nivel de stock período y fiabilidad lo que facilita su análisis y procesamiento
Los parámetros varían según el punto final. Por ejemplo, Inventario Más Reciente acepta códigos de área para especificar ubicaciones, mientras que Series de Tiempo de Inventario permite a los usuarios establecer rangos de fechas utilizando parámetros de "desde" y "hasta". Esta personalización ayuda a adaptar las solicitudes de datos a necesidades específicas
La API cubre los datos de inventario de petróleo crudo para varios países y centros de EE.UU. incluyendo Cushing la Reserva Estratégica de Petróleo y las regiones PADD. Esta amplia cobertura permite un análisis exhaustivo de los inventarios de petróleo globales y regionales
La precisión de los datos se mantiene a través de actualizaciones regulares de fuentes confiables incluyendo informes gubernamentales y publicaciones de la industria El campo de "fiabilidad" en las respuestas indica la credibilidad de la fuente ayudando a los usuarios a evaluar la calidad de los datos
Los casos de uso típicos incluyen análisis de mercado, modelado predictivo y gestión de inventarios. Los analistas pueden usar los datos para predecir tendencias, evaluar niveles de suministro e informar decisiones de inversión basadas en cambios en el stock de petróleo crudo
Los usuarios pueden analizar los datos comparando los niveles de inventario entre regiones, rastreando tendencias históricas y evaluando cambios a lo largo del tiempo. Utilizar los campos "cambio" y "cambio_pct" en los Cambios de Inventario puede ayudar a identificar fluctuaciones significativas en los niveles de inventario