API Terra-Orb
Todos los datos en vivo de Terra-Orb (eventos, artículos, señales tempranas, barómetros, cobertura global) en JSON, de solo lectura, para impulsar Terra-OSINT o cualquier otra herramienta de análisis. Cada artículo viene con su texto completo capturado, resumen, URL original, editor y fechas exactas; /ask devuelve el extracto de cada fuente en la que se basó.
Mejores prácticas para obtener resultados precisos
- · Enviar palabras clave cortas (entidades + términos clave), p.e.
q=aguas residuales vascas de Suez, en lugar de un titular completo. Las consultas largas se reducen automáticamente a sus 5 palabras más distintivas (se eliminan las palabras vacías); la respuesta los muestra entérminos_de consulta. - · Usar
/artículospara cobertura de prensa real (texto completo, fecha, dominio de origen)./señaleses un feed global de alerta temprana: pase siempreqpara mantener solo señales coincidentes. - · Consulta
/artículos,/eventosy/señalesen paralelo, luego aplique su propio umbral de relevancia (por ejemplo, similitud ≥ 0,25 con su título de referencia) antes de mostrarlo.
Acceso y precios
La API es parte del servicio pago: la clave se crea a partir de una cuenta Terra-Orb y se factura en créditos, solo los días en que se solicita.
- · 30 créditos por día de uso, con 1,000 solicitudes incluidas.
- · 10 créditos por bloque de 1,000 solicitudes más allá de eso.
- · API de pago sobre la marcha; Las suscripciones de lectura e investigación son independientes.
| oferta de mercado | Su precio | Volumen | Terra-OrB |
|---|---|---|---|
| TheNewsAPI / Estándar MediaStack | $99/mes | 10.000 a 30.000 solicitudes | ≈ $72 / mes |
| MediaStack Profesional | $249/mes | 50.000 solicitudes | ≈ $184/mes |
| NoticiasAPI Business | $449/mes | 250.000 solicitudes | ≈ $332 / mes |
A igual volumen, Terra-OrB cuesta alrededor de un 20% menos que estas suscripciones, sin compromiso mensual: solo paga por los días realmente llamados y en 222 países y territorios monitoreados (la mayoría cubiertos todos los días) en lugar de una selección de medios de comunicación en inglés.
Parque infantil interactivo
Elija un ejemplo o edite la solicitud, pegue su clave y vea el JSON en vivo. Su clave permanece en esta pestaña del navegador y nunca se almacena. Las llamadas cuentan para su uso como cualquier otra.
curl -H "Autorización: Portador $TERRA_ORB_KEY" \ "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=5"
Puntos finales
Base: /api/público/v1 — todas las respuestas están en JSON e incluyen generado_en.
/api/público/v1/eventos— EventosEventos fusionados de las últimas 24h: fechas exactas/aproximadas, países emisores y afectados, idiomas, número de medios y artículos, tono, intensidad.
Parámetros: tema, emisor=FR, acerca de=IR, búsqueda, ordenar=medios|reciente|fecha|intensita, límite≤300
/api/público/v1/eventos/{id}— Detalle del eventoRegistro completo: desglose de cobertura (titularidad, orientación, país, idioma) y artículos relacionados.
Parámetros: ninguno
/api/público/v1/artículos— Artículos crudosArtículos de las últimas 24 horas: título, URL canónica, fecha del evento versus fecha de publicación, país, tema, tono, tipo de medio (digital/radio/TV/impreso), red social.
Parámetros: q (texto completo), desde/hasta (fechas ISO), alcance=live|archivo|todo (archivo ≈ 1 año), tema, emisor, acerca de, idioma=fr, formulario=digital|radio|tv|imprimir, antes=<fecha ISO> (cursor de paginación), límite≤200
/api/público/v1/preguntar— Motor de respuesta AI (clave completa)Pregunta de formato libre: archivo Terra-OrB y luego web pública, razonamiento crítico, resumen citado [n], matriz de impacto de 4 dominios, fuentes, seguimientos.
Parámetros: GET ?q=...&mode=fast|deep, o POST JSON {pregunta, modo}
/api/público/v1/señales— Señales tempranasEventos detectados antes de una amplia visibilidad: estado, confianza, tasa de aceleración, tiempo de entrega y estadísticas globales.
Parámetros: q (palabras clave, todas deben coincidir), status=detecte|confirme|repris, limit≤300
/api/público/v1/barómetros— BarómetrosFrecuencia y tono cruzados por tema, país e idioma: volumen, salidas, sentimiento, intensidad, tensión, nivel de situación.
Parámetros: ninguno
/api/público/v1/cobertura— Cobertura globalEstado de captura por país: medios activos, artículos recientes, idiomas, estado (cubierto/débil/faltante/sin medio local).
Parámetros: ninguno
/api/público/v1/fuentes— Directorio de mediosPuntos de venta activos: nombre, país, idioma, tipo, canal (feed, página, red social), propiedad y orientación documentadas, confiabilidad.
Parámetros: país=FR, idioma=ar, formulario=tv, tipo=media|social, antes=<id> (cursor de paginación), límite≤500
Ejemplo
curl -H "Autorización: Portador tm_votre_cle" \ "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=20"
Códigos de error: 401 (clave faltante, desconocida o revocada), 402 (créditos agotados), 400 (parámetros no válidos), 404 (recurso no encontrado). La paginación de artículos y fuentes utiliza un cursor: devuelve el valor siguiente_cursor en el parámetro antes.