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 en términos_de consulta.
  • · Usar /artículos para cobertura de prensa real (texto completo, fecha, dominio de origen). /señales es un feed global de alerta temprana: pase siempre q para mantener solo señales coincidentes.
  • · Consulta /artículos, /eventos y /señales en 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 mercadoSu precioVolumenTerra-OrB
TheNewsAPI / Estándar MediaStack$99/mes10.000 a 30.000 solicitudes≈ $72 / mes
MediaStack Profesional$249/mes50.000 solicitudes≈ $184/mes
NoticiasAPI Business$449/mes250.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.

CONSEGUIR /api/público/v1
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.

CONSEGUIR/api/público/v1/eventos— Eventos

Eventos 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

CONSEGUIR/api/público/v1/eventos/{id}— Detalle del evento

Registro completo: desglose de cobertura (titularidad, orientación, país, idioma) y artículos relacionados.

Parámetros: ninguno

CONSEGUIR/api/público/v1/artículos— Artículos crudos

Artí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

CONSEGUIR/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}

CONSEGUIR/api/público/v1/señales— Señales tempranas

Eventos 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

CONSEGUIR/api/público/v1/barómetros— Barómetros

Frecuencia y tono cruzados por tema, país e idioma: volumen, salidas, sentimiento, intensidad, tensión, nivel de situación.

Parámetros: ninguno

CONSEGUIR/api/público/v1/cobertura— Cobertura global

Estado de captura por país: medios activos, artículos recientes, idiomas, estado (cubierto/débil/faltante/sin medio local).

Parámetros: ninguno

CONSEGUIR/api/público/v1/fuentes— Directorio de medios

Puntos 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.