{
"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/13998/crude+oil+inventory+api/33722/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/13998/crude+oil+inventory+api/33723/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/13998/crude+oil+inventory+api/33724/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/13998/crude+oil+inventory+api/33725/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/13998/crude+oil+inventory+api/33726/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/13998/crude+oil+inventory+api/33727/inventory+changes?area=US,US-CUSHING&periods=4&commodity=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Inventário de Petróleo Bruto API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
A API de Inventário de Petróleo Bruto retorna os estoques de petróleo bruto fechados por país e por hub de armazenamento dos Estados Unidos. Os valores estão em mil barris. A cobertura inclui países que reportam estoques e hubs como Cushing, Oklahoma, a Reserva Estratégica de Petróleo e as cinco regiões PADD. O código de commodity ao vivo é crude_oil. Use List Commodities para ler o catálogo, Get Commodity para o perfil e início do histórico, List Commodity Areas para códigos de país e hub, Latest Inventory para o nível atual de cada área, Inventory Time Series para histórico e Inventory Changes para a movimentação em relação ao período anterior. Filtre uma série ou uma alteração com códigos de área como US, JP ou US-CUSHING. Trigo, milho, gás natural, lítio e cobre estão listados como planejados, e as chamadas de inventário para esses códigos retornam indisponível até que fiquem ativos.
Mil barris Inventário de respostas inclui unidade configurada para mil_barris Obter Commodity retorna a mesma unidade no perfil da commodity
Encerramento de estoques de petróleo bruto por país e por centro dos Estados Unidos em milhares de barris Cada linha tem a área o período e o nível de estoque Mudanças de Inventário também retorna a variação em relação ao período anterior e a variação percentual
Países que relatam estoques, além dos centros dos Estados Unidos. Os centros incluem Cushing, Oklahoma, a Reserva Estratégica de Petróleo e as regiões PADD de 1 a 5. Os códigos de área são parecidos com US, JP e US-CUSHING
Passar commodity crude_oil e área US-CUSHING para Últimos Estoques, Séries Temporais de Estoques ou Alterações de Estoques. US-CUSHING é o código do hub para Cushing, Oklahoma
Obter o histórico de retornos de commodities de. Para o petróleo bruto, essa data é 1982-08-20 na série dos Estados Unidos. Outros países começam no primeiro período que existe para aquela área. Defina de na Série Temporal de Estoque para escolher a data de início
O_petróleo_crudo está ao vivo. O trigo o milho o gás natural o lítio e o cobre estão no catálogo com status planejado. Um pedido de inventário para um código planejado retorna indisponível até que essa mercadoria fique ao vivo
Cada endpoint retorna dados específicos relacionados ao estoque de petróleo bruto Por exemplo Último Estoque fornece níveis de estoque atuais Série Temporal de Estoque oferece dados históricos e Mudanças no Estoque mostra as alterações de estoque ao longo do tempo Cada resposta inclui campos relevantes como área período e valor
Os campos principais incluem "área" (código de localização), "nome" (nome da localização), "período" (data dos dados), "valor" (nível de estoque em mil barris) e "reliabilidade" (confiabilidade da fonte de dados) Esses campos ajudam os usuários a entender o contexto e a precisão dos dados
Os dados da resposta estão estruturados em formato JSON, contendo normalmente um campo "commodity", um campo "metric" e um array "data". Cada entrada no array "data" corresponde a uma área específica e inclui métricas relevantes como níveis de estoque e mudanças
Os parâmetros variam de acordo com o endpoint Por exemplo o Inventário Mais Recente pode aceitar códigos de área (como US-CUSHING) para filtrar resultados A Série Temporal de Inventário permite que os usuários especifiquem intervalos de datas usando os parâmetros "de" e "para" para personalizar suas solicitações de dados
Cada endpoint fornece informações distintas: List Commodities mostra as commodities disponíveis Get Commodity detalhes o perfil do petróleo bruto List Commodity Areas enumera países e hubs Latest Inventory fornece níveis de estoque atuais Inventory Time Series apresenta dados históricos e Inventory Changes relata variações de estoque
A precisão dos dados é mantida através de relatórios confiáveis de países e centros de armazenamento Cada resposta inclui um campo de "confiabilidade" que indica a fonte dos dados garantindo que os usuários possam avaliar a credibilidade das informações fornecidas
Casos de uso típicos incluem análise de mercado acompanhamento de inventário e previsão de tendências no setor de energia Analistas e empresas podem usar esses dados para tomar decisões informadas sobre a dinâmica de oferta e demanda de petróleo bruto
Os usuários podem analisar os dados comparando os níveis de estoque em diferentes regiões ou períodos de tempo Por exemplo eles podem acompanhar as mudanças no inventário de Cushing ao longo do tempo usando Mudanças de Inventário ou avaliar tendências gerais nos estoques de petróleo bruto examinando os dados da Série Temporal de Inventário