{
"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'
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 Extrator de Dados de Inventário de Óleo Cru 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 🎉)
O Extrator de Dados de Inventário de Petróleo Bruto API retorna estoques finais de petróleo bruto por país e por centro de armazenamento dos Estados Unidos. Os valores estão em mil barris. A cobertura inclui países que relatam estoques e centros como Cushing, Oklahoma, a Reserva Estratégica de Petróleo e as cinco regiões PADD. O código de mercadoria ao vivo é crude_oil. Use Listar Mercadorias para ler o catálogo, Obter Mercadoria para o perfil e o início da história, Listar Áreas de Mercadoria para códigos de país e centro, Último Inventário para o nível atual de cada área, Série Temporal de Inventário para história, e Mudanças de Inventário para o movimento em relação ao período anterior. Filtre uma série ou uma mudança com códigos de área como US, JP ou US-CUSHING. Trigo, milho, gás natural, lítio e cobre estão listados conforme o planejado, e os chamados de inventário para esses códigos retornam indisponíveis até que entrem em operação.
Mil barris Respostas de inventário incluem unidade configurada para mil_barris Obter Commodity retorna a mesma unidade no perfil da commodity
Fechamento de estoques de petróleo bruto por país e por hub dos Estados Unidos em mil barris Cada linha tem a área o período e o nível de estoque Mudanças de inventário também retorna a mudança em relação ao período anterior e a mudança percentual
Países que reportam estoques, além dos centros dos Estados Unidos. Os centros incluem Cushing, Oklahoma, o Reserva Estratégica de Petróleo e as regiões PADD de 1 a 5. Os códigos de área parecem com US, JP e US-CUSHING
Passar commodity crude_oil e área US-CUSHING para Últimos Estoques, Série Temporal de Estoque ou Mudanças de Estoque US-CUSHING é o código do hub para Cushing, Oklahoma
Obter histórico de retornos de commodities a partir 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 essa área. Defina a partir de na Série Temporal de Inventário para escolher a data de início
O_petróleo_crude 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 chamado de inventário para um código planejado retorna indisponível até que essa commodity entre ao vivo
Cada ponto final retorna dados específicos de inventário de petróleo bruto Por exemplo Estoque Mais Recente fornece níveis de estoque atuais A Série Temporal de Estoque oferece dados históricos e as Mudanças no Estoque mostram variações de estoque ao longo do tempo Cada resposta inclui detalhes relevantes como códigos de área valores e períodos
Os campos chave 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 "confiabilidade" (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, com um objeto principal contendo arrays de "commodities" e "dados". Cada entrada de "dados" inclui campos específicos relevantes para o inventário, como área, valor e período, permitindo fácil análise e interpretação
Os parâmetros variam de acordo com o endpoint Por exemplo o Último Inventário aceita códigos de área para especificar locais enquanto a Série Temporal de Inventário permite que os usuários definam intervalos de datas usando os parâmetros "de" e "para" Os usuários podem filtrar dados com base em países ou hubs específicos
Cada ponto final fornece informações distintas: Listar Commodities mostra as commodities disponíveis, Obter Commodity detalha o perfil do petróleo bruto, Listar Áreas de Commodities enumera países e centros, Último Inventário fornece os níveis de estoque atuais, Série Temporal de Inventário oferece dados históricos e Mudanças no Inventário mostra variações no estoque
Os usuários podem analisar tendências nas reservas de petróleo bruto comparando valores ao longo do tempo usando Séries Temporais de Inventário e avaliar mudanças com Mudanças de Inventário A resposta estruturada permite uma fácil integração em ferramentas de análise de dados ou aplicativos para pesquisa e relatórios
Os dados são originados de países que reportam estoques de petróleo bruto e centros de armazenamento nos EUA Isso inclui relatórios oficiais e estatísticas de agências de energia garantindo um conjunto de dados confiável e abrangente para os usuários
Casos de uso típicos incluem análise de mercado, pesquisa sobre tendências de suprimento de petróleo, gestão de inventário para empresas de energia e previsões econômicas. Os analistas podem aproveitar esses dados para tomar decisões informadas com base nos níveis de inventário atuais e históricos