API · Inteligencia rural por parcela

La misma inteligencia por predio,
ahora a escala de cartera.

Una letra de aptitud por vocación y la volatilidad histórica de una década, por cada parcela — medidos sobre el polígono catastral exacto, no sobre el promedio del municipio. El fondo filtra miles de predios, el banco califica el riesgo de crédito, la reaseguradora fija el strike. Sin enviar un perito a cada campo.

Países cubiertos
46
Parcelas catastrales
+278 M
Serie satelital
10+ años
÷
Un informe es una decisión. La API es una cartera. La unidad no cambia: sigue siendo la parcela, medida sobre su polígono — no el municipio, no la zona.
El mercado valúa hectáreas con ajustes gruesos. Dos campos vecinos al mismo precio pueden rendir un flujo 2 a 3 veces distinto. La API entrega esa diferencia como un número por parcela, consultable a volumen.
Cómo funciona

Coordenada o polígono entra.
Datos por parcela salen.

El mismo motor que produce el informe, sin la capa de render. No hay PDF, no hay imágenes, no hay narrativa: solo el JSON de datos. Para lotes, una cola de trabajos asíncrona procesa la cartera completa.

01
📍

Entra el predio

Coordenada (lat, lon) o polígono. Se resuelve contra el catastro oficial por intersección espacial y se recupera la geometría real de la parcela.

02
🛰️

Se mide sobre el polígono

Suelo, clima, agua, acuífero, inundación y la serie NDVI multitemporal — todo cruzado contra la geometría exacta, no contra el promedio regional.

03
⚙️

Corren los 4 verticales

Ganadero, agrícola, forestal y lechero: encaje, letra de aptitud gateada por el recurso crítico y economía por escenario. Deterministas y auditables.

04
{ }

Devuelve JSON

Solo valores; null para faltantes. Síncrono para una parcela; cola asíncrona con folio para lotes de cartera.

El producto

Tres tiers. Cada uno incluye todo el anterior.

Del filtro a volumen hasta el dato sin procesar. Respuestas reales sobre una parcela de 9.6 ha en Sinaloa, México: cada tier hereda los bloques del anterior y el JSON muestra solo lo que agrega.

API · 1

Screening

El filtro
"¿Cuáles de estas miles de parcelas descarto?"

Una letra de aptitud por vocación y por parcela. Suficiente para que un fondo descarte el 80% de una cartera antes de mirar un solo informe completo, y para que la agroindustria pinte de rojo los proveedores que no aguantan.

La letra ya viene gateada por el recurso crítico: un cultivo puede encajar 84/100 con el sitio y aun así salir letra C si el agua limita. Encaje alto con letra baja no es contradicción — es un buen encaje en un sitio con un limitante.

  • Identidad + geometría (catastro + superficie)
  • 4 verticales: encaje + letra de aptitud + bandera de no ejecutable
  • Agua del sitio: letra + estado + score
Quién lo consumeFondo de tierras que descarta los predios flojos sin abrir un informe · agroindustria que semaforiza su red de proveedores · corredor rural con una ficha de aptitud por propiedad, a costo de volumen
POST/v1/parcela?tier=screening
200 · screening.json
{
  "identidad": {
    "n_catastral": "MX-25017075-0200000100000000125",
    "lat": 25.79668, "lon": -108.59959,
    "superficie_ha": 9.6436, "perimetro_m": 1361.78,
    "ubicacion": "Concentración 5 de Febrero", "pais": "México"
  },
  "verticales": {
    "ganadero": { "encaje": 70, "aptitud_letra": "B", "no_ejecutable": null },
    "agricola":  { "encaje": 84, "aptitud_letra": "C", "no_ejecutable": null },
    "forestal":  { "encaje": 81, "aptitud_letra": "E", "no_ejecutable": true },
    "lechero":   { "encaje": 61, "aptitud_letra": "C", "no_ejecutable": null }
  },
  "agua_sitio": { "letra": "C", "estado": "temporal riesgoso", "score": 64 }
}
API · 2

Riesgo

La dimensión temporal
"¿Qué tan firme es este activo — y dónde está parado frente a su zona?"

El screening dice si la parcela sirve hoy. El tier de riesgo dice qué tan firme es ese resultado a lo largo de una década — la volatilidad del verdor (CV interanual) es lo que separa un activo predecible de uno que truena en el año seco — y dónde queda la parcela frente a su zona: percentil y ratio contra la mediana, el número absoluto convertido en valor relativo.

La valuación productiva viaja etiquetada: es una referencia de renta bajo enfoque de ingreso, nunca un avalúo legal. Ese número alimenta el modelo de quien presta o asegura — no protocoliza una operación.

  • Todo lo de Screening
  • Volatilidad histórica del verdor (CV interanual, años de anomalía, largo de serie)
  • Riesgo productivo derivado (estable / volátil)
  • Capacidad de carga: realista y de año seco
  • Agua del sitio completa: score, distancia, napa, régimen
  • Valuación productiva (referencia de renta, no avalúo)
  • Percentil de aptitud de la zona + ratio vs. mediana (en incorporación)
  • Módulo EUDR para proveedores de frigorífico (piloto)
Quién lo consumeBanco / fintech agro: riesgo de default ligado a la volatilidad del predio que respalda el crédito · frigorífico con compromiso EUDR · aseguradora primaria: prima sobre el riesgo real del predio, no sobre el promedio de la zona
POST/v1/parcela?tier=riesgo
200 · riesgo.json · (+ bloque agregado)
{
  // ...todo lo de screening, más:
  "foso": {
    "ndvi_cv_interanual_pct": 83.36,
    "frac_anios_anomalia_neg": 0.0,
    "anios_serie": 10
  },
  "riesgo_productivo": "volatil",
  "capacidad_carga": { "realista": 3, "conservadora_seca": 2 },
  "agua_sitio_completo": {
    "score": 64, "distancia_m": 3200, "napa_m": 5.6,
    "regimen": "deficit", "estado": "temporal riesgoso"
  },
  "valuacion_productiva_usd_ha_anio": {
    "valor_usd_ha_anio": 1169.5, "uso_referencia": "agricola",
    "tipo": "referencia_income_productivo",
    "nota": "Referencia de renta productiva, NO avalúo legal."
  },
  "percentil_aptitud_zona": null,   // ranking zonal en incorporación
  "ratio_vs_mediana_zona": null,
  "eudr": null   // módulo de deforestación post-2020 · bajo piloto
}
API · 3

Serie cruda

El dato sin cocinar
"Dame la métrica. Yo fijo mi propio modelo."

La serie de picos anuales, las anomalías z por temporada y la malla intra-parcela. No es un veredicto: es el insumo para que la reaseguradora calibre el strike de su paramétrico o el fondo cuantitativo corra su propio modelo.

Es el tier más caro porque entrega la ventaja informacional sin procesar. Se libera solo bajo contrato que la blinde — no se vende por llamada suelta.

  • Todo lo de Riesgo
  • Serie NDVI de picos anuales, multi-año
  • Anomalías z por temporada
  • Malla intra-parcela: vigor y estabilidad por celda (10 m)
Quién lo consumeReaseguradora: el strike del paramétrico sobre el polígono, no un veredicto nuestro · fondo cuantitativo que alimenta su propio modelo de riesgo agroambiental
POST/v1/parcela?tier=serie
200 · serie.json · (+ bloque agregado)
{
  // ...todo lo de riesgo, más:
  "ndvi_serie_picos_anual": {
    "2016": 0.509,  "2017": 0.162,  "2018": 0.536,
    "2019": 0.203,  "2020": 0.101,  "2021": 0.102,
    "2022": 0.117,  "2023": 0.095,  "2024": 0.119,  "2025": 0.106
  },
  "anomalias_z": {
    "2016": 1.78, "2018": 1.94, "2020": -0.61, "2023": -0.65, "…": 0
  },
  "malla_intraparcela": {
    "resolucion_m": 10, "n_celdas": 1344, "anios_en_malla": 10,
    "vigor_p10": 0.090, "vigor_p50": 0.114, "vigor_p90": 0.141,
    "heterogeneidad_pct": 26.32, "clase_heterogeneidad": "muy_heterogeneo",
    "cv_interanual_medio_pct": 46.78, "frac_celdas_inestables": 0.92
  }
}
Comparación

Qué entrega cada tier

Campo / capacidad ScreeningAPI · 1 RiesgoAPI · 2 Serie crudaAPI · 3
Identidad y aptitud
Identidad + geometría catastral
4 verticales: encaje + letra + no ejecutable
Agua del sitio (letra · estado)
Riesgo y estabilidad temporal
Volatilidad del verdor (CV, anomalías, serie)
Riesgo productivo (estable / volátil)
Capacidad de carga (realista · seca)
Agua completa (score · distancia · napa · régimen)
Valuación productiva (referencia de renta)
Percentil de aptitud de zona + ratio vs. medianaen incorp.en incorp.
Módulo EUDR (deforestación post-2020)pilotopiloto
Dato sin cocinar
Serie NDVI de picos anuales (multi-año)
Anomalías z por temporada
Malla intra-parcela (vigor · estabilidad, 10 m)

El percentil de zona y el módulo EUDR están en incorporación; se habilitan por piloto según el caso de uso. El resto está en producción.

Honestidad técnica

Lo que el JSON no es

Lo que delimita el dato es parte de su valor. Quien integra esto a un modelo de crédito o de seguro necesita saber exactamente qué está consumiendo.

No es un avalúo legal

La valuación productiva es una referencia de renta bajo enfoque de ingreso, etiquetada como tal en cada respuesta. Un avalúo con validez para protocolizar lo firma un perito colegiado; eso no es lo que entrega la API.

Lo medido no se mezcla con lo regional

Suelo, clima, agua y NDVI salen medidos sobre el polígono. El contexto regional (referencias de zona) viaja en campos separados. El diferencial entre el predio y su zona es justamente el dato que se vende.

La serie cruda es insumo, no dictamen

El tier 3 entrega la métrica para que usted fije su umbral. No incorpora una decisión nuestra: el strike, el corte de crédito y la prima los define su modelo.

La pastura se reporta por régimen funcional

No se afirma identificación de especie de pasto: la biblioteca espectral todavía no está validada con verificación de campo. Se reporta régimen C3 / C4 por fenología, defendible y auditable.

Integración

Cómo se conecta

REST sobre HTTPS. Autenticación con token. Una parcela responde en línea; una cartera entra a una cola asíncrona y devuelve un folio para recoger el resultado.

ejemplo · lote de cartera
# 1 · autenticación (JWT)
curl -X POST https://api.taurodata.com/auth/token \
  -d '{"api_key":"··········"}'

# 2 · una parcela, en línea
curl -X POST https://api.taurodata.com/v1/parcela?tier=riesgo \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"lat":25.79668,"lon":-108.59959}'

# 3 · cartera completa → cola asíncrona, devuelve folio
curl -X POST https://api.taurodata.com/v1/lote?tier=screening \
  -H "Authorization: Bearer $TOKEN" \
  --data-binary @cartera.csv      # columnas: lat,lon[,id]
 { "folio": "LOTE-7F3A", "parcelas": 512, "estado": "en_cola" }

Catastro resuelto por intersección espacial sobre 46 países. Si el punto no cae sobre una parcela con catastro cargado, la respuesta lo indica explícitamente en lugar de devolver un resultado dudoso.

Modelo de acceso

Del piloto al contrato

01 · Piloto

Pruebe sobre su cartera

Un lote de predios suyos, evaluados con el tier que corresponda a su decisión. Sirve para validar el dato contra lo que usted ya conoce de esos campos.

Piloto pagado sobre su cartera · a convenir por volumen
02 · Por consumo

Tarifa por parcela

Lotes prepagos de 10.000, 50.000 o 100.000 consultas. La escala baja el costo por parcela; el alcance se negocia, el precio de lista no se regala.

Lotes prepagos · precio por consulta según volumen, bajo contrato
03 · Serie cruda

Bajo contrato

El tier 3 entrega el dato en bruto: se libera únicamente con un contrato que blinde el uso del dato. Precio a medida según volumen y exclusividad del caso.

Serie cruda · a medida, solo bajo contrato

Anclas indicativas, a calibrar por volumen y caso de uso. El incentivo de un primer cliente se da en alcance o acceso anticipado, nunca rebajando el precio de lista.

Pruebe con 50 predios de su cartera.

Mándenos un lote real — los suyos, los que ya conoce. Le devolvemos la evaluación por parcela en el tier que corresponda a su decisión, y usted juzga el dato contra lo que sabe de esos campos.