Skip to content

estimativa_safra v1.0

Current crop-year estimates by state.

Sources

Priority Source Description
1 CONAB Crop Monitoring (Acompanhamento de Safra)
2 IBGE LSPA Systematic Survey of Agricultural Production

CONAB covers the current and recent crop years. For crop years CONAB no longer publishes, the IBGE LSPA fallback provides the national aggregate (uf null, unless you filter by state), with levantamento and data_publicacao null.

Products

soja, milho, arroz, feijao, trigo, algodao

Schema

Column Type Nullable Description
safra str ❌ Crop year in "2024/25" format
produto str ❌ Product name
uf str ✅ State
area_plantada float64 ✅ Planted area (thousand ha)
area_colhida float64 ✅ Harvested area (thousand ha)
produtividade float64 ✅ Yield (kg/ha)
producao float64 ✅ Production (thousand tons)
levantamento int ✅ CONAB survey number (1-12); null when the source is LSPA
data_publicacao date ✅ CONAB publication date; null when the source is LSPA
fonte str ❌ Data origin

Guarantees

  • Estimates updated monthly
  • Typical latency: M+0 (current-month data)

Example

from agrobr import datasets

# Current crop year
df = await datasets.estimativa_safra("soja")

# Specific crop year
df = await datasets.estimativa_safra("soja", safra="2024/25")

# Filter by state
df = await datasets.estimativa_safra("milho", uf="MT")

# With metadata
df, meta = await datasets.estimativa_safra("soja", return_meta=True)

JSON Schema

Available at agrobr/schemas/estimativa_safra.json.

from agrobr.contracts import get_contract
contract = get_contract("estimativa_safra")
print(contract.primary_key)  # ['safra', 'produto', 'uf', 'levantamento']
print(contract.to_json())

Crop Year Format

The crop year follows the Brazilian pattern: YYYY/YY

  • 2024/25 = crop year starting in 2024 and ending in 2025
  • Summer crop: sowing Sep–Dec, harvest Jan–May
  • Winter crop: sowing Feb–Apr, harvest Jun–Sep