{
"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/14041/crude+oil+data+retrieval+api/34142/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/14041/crude+oil+data+retrieval+api/34143/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/14041/crude+oil+data+retrieval+api/34144/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/14041/crude+oil+data+retrieval+api/34145/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/14041/crude+oil+data+retrieval+api/34146/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/14041/crude+oil+data+retrieval+api/34147/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 Crude Oil Data Retrieval 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 🎉)
The Crude Oil Data Retrieval API returns closing crude oil stocks by country and by United States storage hub. Values are in thousand barrels. Coverage includes countries that report stocks and hubs such as Cushing, Oklahoma, the Strategic Petroleum Reserve and the five PADD regions. The live commodity code is crude_oil. Use List Commodities to read the catalog, Get Commodity for the profile and history start, List Commodity Areas for country and hub codes, Latest Inventory for the current level of each area, Inventory Time Series for history, and Inventory Changes for the move versus the previous period. Filter a series or a change with area codes such as US, JP or US-CUSHING. Wheat, corn, natural gas, lithium and copper are listed as planned, and inventory calls for those codes return not available until they go live.
Mil barriles La respuesta de inventario incluye unidad configurada en mil_barriles Obtener mercancía devuelve la misma unidad en el perfil de la mercancía
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 periodo y el nivel de existencias. Cambios en inventario también devuelve el cambio respecto al periodo anterior y el cambio porcentual
Países que informan sobre 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 parecen US JP y US-CUSHING
Transfiera la materia prima petróleo_crudo y el área US-CUSHING a Inventario más reciente, Serie Temporal de Inventario o Cambios en Inventario. US-CUSHING es el código del centro de Cushing, Oklahoma
Obtener historia de retornos de materias primas desde. Para el 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 de tiempo 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 planeado Una llamada de inventario para un código planeado devuelve no disponible hasta que esa mercancía esté activa
Cada punto final devuelve datos específicos sobre el petróleo crudo: List Commodities proporciona una visión general del catálogo, Get Commodity detalla el perfil de inventario, List Commodity Areas muestra países y centros, Latest Inventory da los niveles de stock actuales, Inventory Time Series ofrece datos históricos y Inventory Changes informa sobre cambios en el stock a lo largo de periodos
Los campos clave incluyen "mercancía," "métrica," "unidad," "área," "período," "valor," "cambio," y "confiabilidad." Por ejemplo, el Último Inventario incluye "área," "nombre," "período," y "valor" para transmitir los niveles de stock para cada ubicación
Los datos de respuesta están estructurados en formato JSON que generalmente contiene un array "data" con objetos para cada área o registro de inventario. Cada objeto incluye campos relevantes como "area", "valor" y "período" lo que facilita el análisis y la utilización
Los parámetros varían según el punto final. Por ejemplo, Última Inventario acepta códigos de área (por ejemplo, US-CUSHING) y códigos de mercancías (por ejemplo, crudo). Serie Temporal de Inventario permite a los usuarios establecer rangos de fechas con parámetros "desde" y "hasta" para la recuperación de datos históricos
La información incluye los stocks de crudo actuales e históricos, cambios de inventario y perfiles de países y centros. Por ejemplo, Cambios de Inventario proporciona tanto el cambio absoluto como el cambio porcentual en los niveles de stock para áreas especificadas
La precisión de los datos se mantiene a través de actualizaciones regulares de fuentes confiables, incluidos informes gubernamentales y datos de la industria. Cada entrada de inventario incluye un campo de "fiabilidad" que indica la fuente de los datos, como "reportados" o "estimados"
Los casos de uso típicos incluyen análisis de mercado decisiones de inversión y gestión de la cadena de suministro Los usuarios pueden rastrear las tendencias de inventario evaluar las condiciones del mercado y tomar decisiones informadas basadas en datos en tiempo real e históricos
Los usuarios pueden analizar los datos filtrando según códigos de área o períodos de tiempo comparando los niveles de inventario actuales con datos históricos e identificando tendencias en los cambios de stock Esto permite una mejor previsión y planificación estratégica en los mercados energéticos