Guia: Produtividade

Fluxos para consultar dados de produtividade agrícola. Três endpoints disponíveis, independentes entre si — nenhum cadastro prévio é necessário.

1. Produtividade por CAR

Endpoint: GET /api/v1/integration/productivity/{car}

O CAR vai no path. Filtros opcionais via query string permitem refinar ano, cultura, safra e fonte dos dados.

curl -X GET \
  "https://api.merx.tech/api/v1/integration/productivity/MT-5107909-XXXXXXXXXXXX?year=2023&culture=SOY&source=MERX" \
  -H "Authorization: {SUA_API_KEY}"

Query param	Descrição	Obrigatório	Padrão
year	Ano de referência	Não	—
culture	SOY, CORN, SUGAR_CANE, RICE, COTTON, COFFEE, CITRUS, PALM	Não	—
source	MERX, MAPBIOMAS	Não	MERX
excludeSmallerAreas	Excluir áreas pequenas	Não	true
includeGeoJson	Incluir geometria na resposta	Não	false
harvest	Safra (ex: 2022/2023)	Não	—

Detalhes em Produtividade por CAR.

2. Produtividade por CAR e cultura

Endpoint: GET /api/v1/integration/productivity/{car}/cultures/{culture}

Use quando já conhece a cultura e quer uma resposta filtrada. harvest é obrigatório neste endpoint.

curl -X GET \
  "https://api.merx.tech/api/v1/integration/productivity/MT-5107909-XXXXXXXXXXXX/cultures/SOY?harvest=2022/2023&source=MERX" \
  -H "Authorization: {SUA_API_KEY}"

Parâmetro	Onde	Obrigatório
car	Path	Sim
culture	Path — SOY, CORN, SUGAR_CANE, RICE, COTTON, COFFEE, CITRUS, PALM	Sim
harvest	Query — identificador da safra	Sim
source	Query — MERX, MAPBIOMAS	Não (padrão MERX)
excludeSmallerAreas	Query	Não (padrão true)
includeGeoJson	Query	Não (padrão false)

Detalhes em Produtividade por CAR e cultura.

3. Produtividade por município

Endpoint: GET /api/v1/integration/productivity/city

Os filtros cityCode e culture vão via query string — não no path. cityCode é o código IBGE do município.

curl -X GET \
  "https://api.merx.tech/api/v1/integration/productivity/city?cityCode=5208707&culture=SOY" \
  -H "Authorization: {SUA_API_KEY}"

Query param	Descrição	Obrigatório
cityCode	Código IBGE da cidade	Não
culture	Cultura agrícola	Não

Detalhes em Produtividade por município.

Nota

Os dados de produtividade são baseados em informações públicas de safra. Nenhum cadastro prévio é necessário.