AgroDoc API.

REST simples · JSON · sem auth · cache 30min · CEPEA ao vivo · use livremente com atribuição.

Endpoints

GET /api/v1/cotacao

Retorna cotação atual do boi gordo, vaca, soja, milho, bezerro MS.

Query params: ?uf=MS (opcional) — adiciona preço físico do estado.

Exemplo:

curl https://agrodocai.com.br/api/v1/cotacao

Resposta:

{
  "boi_gordo_cepea_sp": 365.10,
  "boi_gordo_praca": "CEPEA/ESALQ SP (oficial)",
  "vaca_gorda": 310.33,
  "soja": 128.00,
  "milho": 66.81,
  "bezerro_ms": 3372.00,
  "atualizado": "2026-04-18T09:30:00-04:00",
  "fonte": "CEPEA/ESALQ · NoticiasAgricolas · Scot Consultoria",
  "api_version": "v1",
  "license": "CC-BY-4.0 · atribuição AgroDoc AI"
}

GET /api/v1/cotacao?uf=MS

Adiciona campo boi_gordo_uf com preço físico da praça do estado:

{
  "boi_gordo_cepea_sp": 365.10,
  "boi_gordo_uf": {
    "uf": "MS",
    "preco": 360.00,
    "praca": "MS C. Grande"
  },
  ...
}

Uso e limites

· Sem autenticação · sem rate limit explícito (use com moderação)
· Cache servidor 30 minutos · dados atualizam automaticamente
· CORS liberado pra todos os domínios
· Licença CC-BY-4.0 · cite "AgroDoc AI" ao publicar

Integração — Google Sheets

Cole em qualquer célula do Sheets:

=IMPORTJSON("https://agrodocai.com.br/api/v1/cotacao", "/boi_gordo_cepea_sp")

Integração — Zapier / IFTTT

Use Webhooks by Zapier · trigger "New Day" · action "GET https://agrodocai.com.br/api/v1/cotacao" · despacha pra Slack/Email/Telegram/etc.

Roadmap ativo · desenvolvido conforme demanda real de parceiros

· POST /api/v1/romaneio — OCR de romaneio (beta · contato pra acesso)
· GET /api/v1/simulador — simulador de venda
· GET /api/v1/historico — série histórica CEPEA

Contato devs

Bug · feedback · feature request · integração enterprise:
WhatsApp: wa.me/5567936182263
Email: marcello_zamproni@hotmail.com