Ir para o conteúdo

CONAB CEASA/PROHORT

Precos diários de atacado de hortifruti em 43 CEASAs do Brasil (48 produtos).

conab.ceasa_precos()

Precos mais recentes de atacado por produto x CEASA.

import agrobr

df = await agrobr.conab.ceasa_precos(produto="tomate")

Parâmetros

Parâmetro Tipo Obrigatório Descrição
produto str Não Filtrar por produto (ex: "tomate", "ABACAXI"). Case-insensitive. Produto fora do publicado levanta InvalidParameterError com a lista; valor que não é texto, antes do pedido
ceasa str Não Filtrar por CEASA (ex: "CEAGESP - SAO PAULO", "SAO PAULO"). Case-insensitive, busca parcial; precisa casar ao menos 1 CEASA publicada
as_polars bool Não Se True, retorna polars.DataFrame
return_meta bool Não Se True, retorna (DataFrame, MetaInfo)

Colunas de Retorno

Coluna Tipo Descrição
data datetime Data do preco (por CEASA, extraida do header)
produto str Nome do produto (ex: TOMATE, ABACAXI)
categoria str FRUTAS, HORTALICAS ou OVOS; nula (com aviso) para produto fora da tabela do agrobr
unidade str KG, UN ou DZ
ceasa str Nome da CEASA (ex: CEAGESP - SAO PAULO)
ceasa_uf str UF da CEASA (ex: SP)
preco float Preco em R$ (nulls filtrados)

conab.ceasa_produtos()

Lista dos 48 produtos monitorados pelo PROHORT.

import agrobr

produtos = agrobr.conab.ceasa_produtos()

Retorno

Lista ordenada de strings (ex: ["ABACATE", "ABACAXI", ..., "VAGEM"]).

conab.lista_ceasas()

Lista das 43 CEASAs com UF.

import agrobr

ceasas = agrobr.conab.lista_ceasas()
for c in ceasas[:3]:
    print(c["nome"], c["uf"])

Retorno

Lista de dicts com nome e uf para cada CEASA, ordenada por nome.

conab.ceasa_categorias()

Categorias de produtos (FRUTAS, HORTALICAS, OVOS). FRUTAS e HORTALICAS seguem os grupos do painel oficial "Hortaliças e Frutas" do PROHORT (Portal de Informações da Conab); OVOS fica fora dos dois grupos oficiais. Brócolo, cará, couve, jiló, mandioquinha, quiabo e vagem não aparecem no painel e ficam em HORTALICAS por classificação do agrobr.

import agrobr

cats = agrobr.conab.ceasa_categorias()
print(f"Frutas: {len(cats['FRUTAS'])}")
print(f"Hortalicas: {len(cats['HORTALICAS'])}")

Uso Síncrono

from agrobr import sync

df = sync.conab.ceasa_precos(produto="tomate")
produtos = sync.conab.ceasa_produtos()
ceasas = sync.conab.lista_ceasas()

Exemplos

Preco do tomate em SP

import agrobr

df = await agrobr.conab.ceasa_precos(produto="tomate", ceasa="SAO PAULO")
print(df[["ceasa", "preco", "unidade"]])

Todas as frutas

import agrobr

df = await agrobr.conab.ceasa_precos()
frutas = df[df["categoria"] == "FRUTAS"]
print(frutas.groupby("produto")["preco"].mean().sort_values(ascending=False))

Comparar precos entre CEASAs

import agrobr

df = await agrobr.conab.ceasa_precos(produto="tomate")
print(df[["ceasa", "ceasa_uf", "preco"]].sort_values("preco"))

Fonte dos Dados

  • Provedor: CONAB — Companhia Nacional de Abastecimento
  • Sistema: PROHORT (Programa Brasileiro de Modernizacao do Mercado Hortigranjeiro)
  • Frequência: Diaria (precos de atacado)
  • Cobertura: 48 produtos (21 frutas, 26 hortaliças e ovos), 43 CEASAs, 20 UFs
  • Formato: JSON (Pentaho CDA REST API)
  • Licença: zona_cinza (credenciais publicas embutidas, API não documentada oficialmente)
  • Portal: Portal de Informações CONAB