🔍 Administración de Scrapers
Gestiona y ejecuta tus scrapers (Power BI, SAG y Syngenta)
⏰ Ejecución Automática (Scheduler)
Configura la ejecución diaria automática de todos los scrapers
🔑 Administración de API Keys
Genera y gestiona API keys para monetizar el acceso a los datos
📚 Documentación de API
Consulta datos directamente desde aplicaciones externas
🌐 Información General
Esta API permite consultar los datos extraídos por los scrapers sin necesidad de almacenarlos en tu propia base de datos. Todos los endpoints soportan filtros y paginación para facilitar la integración con aplicaciones externas.
Cargando...
🔌 Conectar desde Aplicaciones Externas
🔐 Autenticación con API Key
Esta API requiere autenticación mediante API key.
Todas las consultas de datos deben incluir el header X-API-Key con una API key válida.
1. Ve al módulo 🔑 API Keys en el menú lateral
2. Haz clic en + Generar Nueva API Key
3. Ingresa los datos del cliente y genera la key
4. Copia la API key generada (formato:
sk_live_...)
📋 Ejemplos de Integración
JavaScript / Node.js
// Consultar registros de SAG Chile con filtros
const response = await fetch('https://sag.xportplan.com/api/records/sag-chile?especie=MANZANO&limit=100', {
headers: {
'X-API-Key': 'sk_live_TU_API_KEY_AQUI'
}
});
const data = await response.json();
console.log(`Total: ${data.total}`);
data.records.forEach(record => {
console.log(`${record.codigo_sag} - ${record.especie} - ${record.region}`);
});
Python
import requests
# Consultar datos de SAG México con clasificación
url = 'https://sag.xportplan.com/api/records/sagmex'
headers = {
'X-API-Key': 'sk_live_TU_API_KEY_AQUI'
}
params = {
'clasificacion': 'A',
'region': 'METROPOLITANA',
'limit': 50
}
response = requests.get(url, headers=headers, params=params)
data = response.json()
print(f"Total de registros: {data['total']}")
for record in data['records']:
print(f"{record['codigo_sag']} - {record['clasificacion']}")
cURL
# Consultar estadísticas de Syngenta
curl -X GET "https://sag.xportplan.com/api/stats/syngenta" \
-H "X-API-Key: sk_live_TU_API_KEY_AQUI"
# Consultar registros con paginación
curl -X GET "https://sag.xportplan.com/api/records/sag-chile?limit=100&offset=0" \
-H "X-API-Key: sk_live_TU_API_KEY_AQUI"
Excel / Power BI
Puedes importar los datos directamente en Excel o Power BI usando la función Obtener datos desde la Web
y proporcionando la URL del endpoint (ej: https://sag.xportplan.com/api/records/sag-chile).
💡 Recomendaciones
- Paginación: Usa los parámetros
limityoffsetpara consultas grandes - Filtros: Aprovecha los filtros de especie, región y clasificación para optimizar las consultas
- Caché: Implementa caché local para reducir la cantidad de peticiones
- Estadísticas primero: Consulta los endpoints
/api/stats/*antes de descargar datos masivos
🇨🇱 SAG Chile - Sitios de Producción
Consulta registros de sitios de producción aprobados por SAG Chile (~4,659 registros, 233 páginas).
Parámetros de consulta (opcionales):
- codigos - Buscar múltiples SDP separados por coma (ej: 46993,12345,67890). Máx 100 códigos NUEVO
- run_id - Filtrar por ID de ejecución específica
- especie - Filtrar por especie (ej: "Arándano")
- region - Filtrar por región (ej: "Maule")
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Obtiene estadísticas agregadas de los datos de SAG Chile.
Ejemplo cURL:
Respuesta de ejemplo:
🇲🇽 SAG México - Registro de Exportación
Consulta registros de sitios habilitados para exportación a México con campo CLASIFICACIÓN (~12,625 registros, 632 páginas).
Parámetros de consulta (opcionales):
- codigos - Buscar múltiples SDP separados por coma (ej: 46993,12345,67890). Máx 100 códigos
- clasificacion - Filtrar por clasificación: "A", "B", "C*", "Excluido" IMPORTANTE
- especie - Filtrar por especie
- region - Filtrar por región
- run_id - Filtrar por ID de ejecución específica
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Obtiene estadísticas agregadas incluyendo distribución de clasificaciones.
Ejemplo cURL:
Respuesta de ejemplo:
📊 Power BI - Datos de Monitoreo
Consulta datos de monitoreo extraídos de dashboards de Power BI con 8 columnas específicas.
Columnas disponibles:
- csg - Código CSG del sitio
- sector - Nombre del sector
- variedad - Variedad de planta
- fecha_muestreo - Fecha de muestreo
- momento_muestra - Momento de toma de muestra
- deteccion - Detección Cydia pomonella
- observaciones - Observaciones del monitoreo
- ar_km - AR C. capitata
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- csg - Filtrar por código CSG (búsqueda parcial)
- sector - Filtrar por sector (búsqueda parcial)
- variedad - Filtrar por variedad (búsqueda parcial)
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Obtiene estadísticas agregadas de los datos de Power BI.
Ejemplo cURL:
Respuesta de ejemplo:
🌱 Syngenta - Red de Monitoreo (PDF)
Consulta registros extraídos de PDFs del portal SAG para la Red de Monitoreo Syngenta.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- especie - Filtrar por especie
- region - Filtrar por región
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Obtiene estadísticas agregadas de los datos de Syngenta.
Respuesta de ejemplo:
🇨🇳 China - Registros Multi-especie
Consulta registros de exportación a China extraídos de archivos Excel del portal SAG. Incluye tanto CSG (Orchard) como CSP (Facilities) de múltiples especies. Soporta consulta por múltiples CSG en una sola llamada.
Parámetros de consulta (opcionales):
- codigos - Lista de códigos CSG separados por coma (máx 100). Ej: codigos=89147,89148,113231
- csg - Buscar por código CSG individual (búsqueda parcial)
- run_id - Filtrar por ID de ejecución específica
- especie - Filtrar por especie (ej: CHERRY, TABLE GRAPE, APRICOT)
- region - Filtrar por región
- tipo_registro - Filtrar por tipo: CSG o CSP
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL - Consulta múltiples CSG:
Ejemplo cURL - Filtro por especie:
Respuesta de ejemplo:
Obtiene estadísticas agregadas de los datos de exportación a China. Incluye distribución por especie, tipo de registro (CSG/CSP) y regiones.
Ejemplo cURL:
Respuesta de ejemplo:
🦋 Lobesia - Prospección Lobesia botrana
Consulta registros de prospección de Lobesia botrana extraídos de archivos Excel del portal SAG Chile. Incluye datos de huertos monitoreados, especies, resultados de análisis y coordenadas geográficas.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- especie - Filtrar por especie (ej: CEREZA, ARÁNDANO)
- region - Filtrar por región
- resultado - Filtrar por resultado (SIN DETECCIÓN, POSITIVA)
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Obtiene estadísticas agregadas de los datos de prospección de Lobesia botrana. Incluye distribución por especie, resultado y regiones.
Ejemplo cURL:
Respuesta de ejemplo:
🦋 Lobesia Otros - Predios Reglamentados (Ciruelo, Vid, Arándano)
Consulta registros de predios dentro del área reglamentada por Lobesia botrana para tres especies adicionales: Ciruelo, Vid (Uva de mesa) y Arándano. Datos extraídos de archivos Excel multi-hoja del portal SAG Chile (~15,853 registros en 9 regiones).
Parámetros de consulta (opcionales):
- codigos - Buscar múltiples CSG separados por coma (ej: 3176734,3167089). Máx 1000 códigos BULK
- csg - Buscar un CSG específico (búsqueda exacta)
- especie - Filtrar por especie: CIRUELO, UVA, ARANDANO
- region - Filtrar por región (ej: Metropolitana, Maule, Ñuble)
- comuna - Filtrar por comuna
- dentro_area_control - Filtrar por estado: SI o NO
- limit - Límite de registros (default: 10000, máx: 10000)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL - Consulta por múltiples CSGs:
Ejemplo cURL - Filtrar por especie y región:
Respuesta de ejemplo:
Obtiene estadísticas agregadas de los predios reglamentados por Lobesia botrana (otras especies). Incluye distribución por especie y región.
Ejemplo cURL:
Respuesta de ejemplo:
🍇 Predios UVA - Uva de Mesa para México
Consulta registros de predios de Uva de Mesa para México ubicados dentro del área reglamentada por Lobesia botrana. Datos extraídos de archivo Excel multi-hoja del portal SAG Chile.
Parámetros de consulta (opcionales):
- codigos - Buscar múltiples CSG separados por coma (ej: 3176734,3167089). Máx 1000 códigos BULK
- csg - Buscar un CSG específico (búsqueda exacta)
- region - Filtrar por región (ej: Metropolitana, Maule, Ñuble)
- comuna - Filtrar por comuna
- dentro_area_control - Filtrar por estado: SI o NO
- limit - Límite de registros (default: 10000, máx: 10000)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL - Consulta por múltiples CSGs:
Ejemplo cURL - Filtrar por región:
Respuesta de ejemplo:
Obtiene estadísticas agregadas de los predios de Uva de Mesa para México. Incluye distribución por región.
Ejemplo cURL:
Respuesta de ejemplo:
🪰 Mosca - Campañas Mosca de la Fruta
Consulta registros de campañas de Mosca de la Fruta extraídos de archivos Excel del portal SAG Chile. Incluye tanto CSG (predios) como CSP (establecimientos) dentro del área reglamentada.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- tipo_registro - Filtrar por tipo: CSG o CSP
- radio - Filtrar por zona geográfica de control (ej: 7,2 | 7,5 | 15 | 27,2 | 80)
- region - Filtrar por región
- campana - Filtrar por nombre de campaña
- codigos - Buscar múltiples CSG/CSP separados por coma (ej: 116191,123456,789012). Máx 100 códigos
- latest_only - Si es
true, devuelve solo el registro más reciente por código con el radio más restrictivo (menor número) de esa fecha. Funciona con o sin el parámetrocodigos - limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL - Todos los códigos (solo más recientes):
Ejemplo cURL - Códigos específicos (solo más recientes):
Ejemplo cURL - Filtros tradicionales:
Respuesta de ejemplo (con latest_only=true):
Obtiene estadísticas agregadas de los datos de campañas de Mosca de la Fruta. Incluye distribución por tipo de registro (CSG/CSP), campañas y regiones.
Ejemplo cURL:
Respuesta de ejemplo:
🇰🇷 Corea - Exportación a Corea (Multi-especie)
Consulta registros de participantes inscritos para exportación a Corea extraídos de archivos Excel del portal SAG Chile. Incluye tanto CSG (Orchards) como CSP (Facilities) con control de cambios por archivo individual.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- especie - Filtrar por especie (ej: ARÁNDANO)
- tipo_registro - Filtrar por tipo (CSG o CSP)
- region - Filtrar por región
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Obtiene estadísticas agregadas de los datos de exportación a Corea. Incluye distribución por especie, tipo de registro (CSG/CSP) y regiones.
Ejemplo cURL:
Respuesta de ejemplo:
🚫 Descolgados - Productores y Variedades Excluidas
Consulta registros de productores y variedades excluidas del portal SAG DESCOLGADOS con autenticación. Incluye campos JSONB con arrays para países y plagas.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- rut_productor - Buscar por RUT del productor
- nombre_productor - Buscar por nombre (LIKE)
- variedad - Filtrar por variedad
- pais - Filtrar por país específico en array paises_a_descolgar
- plaga - Filtrar por plaga específica en array plagas
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Obtiene estadísticas de productores excluidos incluyendo distribución por país, plaga y variedad.
Ejemplo cURL:
Respuesta de ejemplo:
🇯🇵 Japón - Systems Approach Cerezas
Consulta registros de participantes en Systems Approach para exportación de cerezas a Japón. Incluye tanto CSG (Orchards) como CSP (Facilities) con estructura unificada.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- region - Filtrar por región
- comuna - Filtrar por comuna
- variedad - Filtrar por variedad de cereza
- tipo_registro - Filtrar por tipo (CSG o CSP)
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Obtiene estadísticas de participantes en Systems Approach Japón con distribución por región, comuna y variedad.
Respuesta de ejemplo:
🇺🇸 USA - Systems Approach (Multi-dataset)
⚠️ Arquitectura Multi-dataset: Este scraper genera 2 tablas separadas (arándanos y ciruelas) con endpoints independientes. Cada dataset tiene su propio CSV, modelo de datos y endpoints REST.
📘 Arándanos (Blueberries)
Consulta registros de predios participantes en Systems Approach para exportación de arándanos a USA.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- region - Filtrar por región
- codigo - Buscar por código de predio
- tipo_registro - Filtrar por tipo (Participantes/Aprobados)
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Estadísticas de arándanos con distribución por regiones, comunas y productores.
Respuesta de ejemplo:
🍇 Ciruelas (Plums)
Consulta registros CSG de predios para exportación de ciruelas a USA.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- region - Filtrar por región
- codigo - Buscar por código CSG
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Estadísticas de ciruelas con distribución por regiones y productores.
Respuesta de ejemplo:
🇧🇷 Brasil - SMR Brasil (Multi-dataset)
⚠️ Arquitectura Multi-dataset: Sistema de Mitigación de Riesgo Brasil con 2 tablas separadas: CSG/CSP (ciruelas, arándanos, uva) y SDP (kiwi). Cada dataset tiene endpoints independientes.
🌿 CSG/CSP - Ciruelas, Arándanos, Uva
Consulta registros CSG/CSP de participantes inscritos en SMR Brasil para ciruelas, arándanos y uva.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- region - Filtrar por región
- especie - Filtrar por especie (ciruelas, arandanos, uva)
- tipo_registro - Filtrar por tipo (CSG, CSP, SDP)
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Estadísticas de registros CSG/CSP con distribución por región, especie y tipo.
Respuesta de ejemplo:
🥝 SDP - Kiwi
Consulta registros SDP aprobados para exportación de kiwi a Brasil.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- region - Filtrar por región
- especie - Filtrar por especie
- codigo - Buscar por código SDP
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Estadísticas de registros SDP con distribución por región y especie.
Respuesta de ejemplo:
🇨🇳 ChinaPort - API Directa chinaport.gov.cn
⚡ API REST Directa: Este scraper consulta directamente la API de ChinaPort sin necesidad de navegación web. Extrae ~20,652 registros con paginación automática.
Consulta registros de instalaciones chilenas registradas en ChinaPort. Las especies vienen parseadas en un array JSON.
Parámetros de consulta (opcionales):
- run_id - Filtrar por ID de ejecución específica
- csg - Buscar por código CSG chileno
- especie - Filtrar por especie en array especies
- estado - Filtrar por estado: "1" (Activo) o "0" (Inactivo)
- empresa - Buscar por nombre de empresa
- region - Filtrar por región
- limit - Límite de registros (default: 100)
- offset - Desplazamiento para paginación (default: 0)
Ejemplo cURL:
Respuesta de ejemplo:
Obtiene estadísticas de registros ChinaPort con distribución por estado, región y empresas top.
Ejemplo cURL:
Respuesta de ejemplo:
🔍 Búsqueda Consolidada - CSG y SDP (NUEVO)
✨ Endpoints de Búsqueda Unificada
Estos endpoints permiten buscar un código CSG (Código de Sitio de Gestión - establecimiento/huerto) o SDP (Sitio De Producción) en todas las fuentes disponibles con una sola petición.
🎯 CSG: Busca en 12 fuentes | 🎯 SDP: Busca en 4 fuentes
Búsqueda consolidada por CSG (establecimiento/huerto). Retorna información de todas las fuentes donde aparece el código, incluyendo especies, variedades, sectores, regiones y programas de exportación asociados.
📊 Fuentes consultadas (12 tablas):
- SYNGENTA
- Aprobados Corea - Japon
- Inscritos China
- Lobesia
- Mosca
- Inscritos Corea
- Descuelgues Planta
- Japon System Approach
- USA System approach Arandano
- USA System Approach Ciruela
- Brasil CSG
- China API
🔐 Autenticación (dos opciones):
- Authorization: Bearer {api_key} - Recomendado (estándar REST)
- X-API-Key: {api_key} - Alternativa compatible
Ejemplo cURL:
Ejemplo Python:
Ejemplo JavaScript/Node.js:
Ejemplo Excel / Power BI:
Respuesta de ejemplo:
Búsqueda consolidada por SDP (Sitio De Producción). Retorna información de todas las fuentes donde aparece el código, incluyendo especies, variedades, regiones, clasificaciones de riesgo y CSG asociados.
📊 Fuentes consultadas (4 tablas):
- SDP Chile - Sitios de Producción Aprobados (codigo_sag es SDP)
- SDP Mexico - Registro para Exportación (codigo_sag es SDP + clasificación)
- Brasil SDP - SMR Brasil códigos SDP (kiwi)
- SYNGENTA Mexico - SDPs asociados a CSG (sdp_mexico)
Ejemplo cURL:
Ejemplo Python:
Respuesta de ejemplo:
⚠️ Diferencias Clave: CSG vs SDP
🏭 CSG (Código de Sitio de Gestión)
- Qué es: Establecimiento/Huerto/Empacadora
- Fuentes: 12 tablas distintas
- Incluye: Sectores, especies, variedades, programas de exportación
- Ejemplo:
94467
🌱 SDP (Sitio De Producción)
- Qué es: Sitio de producción aprobado
- Fuentes: 4 tablas distintas
- Incluye: Especies, variedades, clasificaciones, CSG asociados
- Ejemplo:
64585
codigo_sag como SDP, no CSG.
Syngenta vincula SDP (sdp_mexico) con CSG (codigo_sag).
💡 Notas de Integración
- ✅ Todos los endpoints soportan CORS para llamadas desde navegadores
- ✅ Autenticación requerida: Incluye el header
X-API-Keyen tus peticiones - ✅ Los datos se actualizan cada vez que ejecutas un scraper
- ✅ Usa paginación (
limityoffset) para grandes volúmenes - ⚠️ El campo clasificacion en SAG México indica el estado de aprobación (A/B/C*/Excluido)
- ⚠️ Los datos de Power BI incluyen 8 columnas específicas de monitoreo
- ⚠️ CHINA: El campo tipo_registro indica si es CSG (Orchard) o CSP (Facility). Los CSP no tienen grower_name (NULL)
- ⚠️ LOBESIA: Incluye 20 columnas con datos de prospección de Lobesia botrana, coordenadas geográficas y resultados de análisis
- ⚠️ MOSCA: El campo tipo_registro indica si es CSG (Predio) o CSP (Establecimiento). El campo radio indica la zona geográfica de control de la campaña (7,2 | 7,5 | 15 | 27,2 | 80). Los CSP no tienen campo "predio" (NULL)
- ⚠️ COREA: Estructura idéntica a CHINA con control de cambios por archivo. El campo tipo_registro indica si es CSG (Orchard) o CSP (Facility)
- ⚠️ DESCOLGADOS: Incluye campos JSONB paises_a_descolgar y plagas que contienen arrays de strings. Usa filtros específicos para consultar por país o plaga
- ⚠️ JAPÓN: Systems Approach cerezas con 16 columnas unificadas para CSG/CSP. Incluye variedades y fechas de actualización
- ⚠️ USA: Arquitectura multi-dataset con endpoints separados para arándanos y ciruelas. Cada especie tiene su propio CSV y tabla
- ⚠️ BRASIL: Arquitectura multi-dataset con 2 tablas: brasil_csg_records (CSG/CSP multi-especie) y brasil_sdp_records (SDP kiwi). Total 11,817 registros
- ⚠️ CHINAPORT: API REST directa a chinaport.gov.cn con paginación automática. Especies parseadas a JSON array desde campo prodNameEn
- ⚠️ VIETNAM: Similar a China con archivos Excel multi-especie. Incluye Cherry, Table Grape y Apple con campo temporada (ej: 2024-2025)