{
"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'
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 Buscar dados de 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 Dados do Inventário de Petróleo Bruto Fetch retorna os estoques de petróleo bruto de fechamento por país e por centro de armazenamento dos Estados Unidos. Os valores estão em milhares de barris. A cobertura inclui países que relatam estoques e centros como Cushing, Oklahoma, o Fundo Estratégico de Petróleo e as cinco regiões PADD. O código da mercadoria ao vivo é crude_oil. Use List Commodities para ler o catálogo, Get Commodity para o perfil e início de histórico, List Commodity Areas para códigos de país e centro, 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 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 as chamadas de inventário para esses códigos retornam indisponível até que fiquem ativos.
Mil barris Respostas de inventário incluem unidade definida como mil_barris Obter Commodity retorna a mesma unidade no perfil da mercadoria
Fechamento dos estoques de petróleo bruto por país e por centro dos Estados Unidos em mil barris Cada linha contém a área o período e o nível de estoque As Mudanças de Inventário também retornam 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, o Reservatório Estratégico de Petróleo e as regiões PADD de 1 a 5. Os códigos de área se parecem com US, JP e US-CUSHING
Passe a commodity crude_oil e a área US-CUSHING para o Último Inventário, Série Temporal de Inventário ou Mudanças de Inventário US-CUSHING é o código do hub para Cushing Oklahoma
Obtenha o 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 Estoques para escolher a data de início
O_petróleo_bruto está ativo O trigo o milho o gás natural o lítio e o cobre estão no catálogo com status planejado Uma chamada de inventário para um código planejado retorna indisponível até que essa mercadoria fique ativa
Cada ponto final retorna dados específicos de 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 de Estoque mostra variações de estoque ao longo do tempo Cada resposta inclui métricas relevantes e detalhes da área
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 os níveis de inventário e seu contexto
Os dados de resposta estão estruturados no formato JSON, com um objeto principal contendo metadados e um array "data". Cada entrada no array corresponde a uma área específica, detalhando seu nível de estoque, período e confiabilidade, facilitando a análise e a interpretação
Os parâmetros variam conforme o endpoint Por exemplo Latest Inventory aceita códigos de área para especificar locais enquanto Inventory Time Series permite que os usuários definam intervalos de datas usando os parâmetros "de" e "para" Essa personalização ajuda a adaptar os pedidos de dados às necessidades específicas
A API cobre dados de inventário de petróleo bruto para vários países e centros dos EUA, incluindo Cushing, o Reserva Estratégica de Petróleo e regiões PADD. Essa ampla cobertura permite uma análise abrangente dos estoques de petróleo globais e regionais
A precisão dos dados é mantida através de atualizações regulares de fontes confiáveis, incluindo relatórios governamentais e publicações do setor. O campo "confiabilidade" nas respostas indica a credibilidade da fonte, ajudando os usuários a avaliar a qualidade dos dados
Os casos de uso típicos incluem análise de mercado modelagem preditiva e gerenciamento de inventário Analistas podem usar os dados para prever tendências avaliar níveis de suprimento e informar decisões de investimento com base nas mudanças nos estoques de petróleo bruto
Os usuários podem analisar os dados comparando os níveis de estoque entre regiões, acompanhando tendências históricas e avaliando mudanças ao longo do tempo Utilizar os campos "change" e "change_pct" em Mudanças de Inventário pode ajudar a identificar flutuações significativas nos níveis de estoque