API Terra-Orb

Todos os dados ao vivo do Terra-Orb — eventos, artigos, sinais iniciais, barômetros, cobertura global — em JSON, somente leitura, para alimentar o Terra-OSINT ou qualquer outra ferramenta de análise. Cada artigo vem com texto completo capturado, resumo, URL original, editora e datas exatas; /ask retorna o trecho de cada fonte em que se baseou.

Melhores práticas para resultados precisos

  • · Envie palavras-chave curtas (entidades + termos-chave), por exemplo q=Águas residuais bascas de Suez, em vez de um título completo. Consultas longas são reduzidas automaticamente às 5 palavras mais distintas (palavras irrelevantes removidas); a resposta os mostra em termos_de_consulta.
  • · Usar /artigos para cobertura real da imprensa (texto completo, data, domínio de origem). /sinais é um feed global de alerta precoce: sempre passe q para manter apenas sinais correspondentes.
  • · Consulta /artigos, /eventos e /sinais em paralelo, aplique seu próprio limite de relevância (por exemplo, similaridade ≥ 0,25 com seu título de referência) antes da exibição.

Acesso e preços

A API faz parte do serviço pago: a chave é criada a partir de uma conta Terra-Orb e é cobrada em créditos, apenas nos dias em que for chamada.

  • · 30 créditos por dia de uso, com 1,000 pedidos incluídos.
  • · 10 créditos por bloco de 1,000 solicitações além disso.
  • · API pré-paga conforme o uso; as assinaturas de leitura e investigação são separadas.
Oferta de mercadoSeu preçoVolumeTerra-OrB
Padrão TheNewsAPI/MediaStackUS$ 99/mês10.000 a 30.000 solicitações≈ $ 72 / mês
MediaStack ProfissionalUS$ 249/mês50.000 solicitações≈ $ 184 / mês
Negócios da NewsAPIUS$ 449/mês250.000 solicitações≈ $ 332 / mês

No mesmo volume, o Terra-OrB custa cerca de 20% menos do que essas assinaturas, sem compromisso mensal: você paga apenas pelos dias realmente chamados e em 222 países e territórios monitorados (a maioria cobertos todos os dias), em vez de uma seleção de canais de língua inglesa.

Parque interativo

Escolha um exemplo ou edite a solicitação, cole sua chave e veja o JSON ativo. Sua chave permanece nesta aba do navegador e nunca é armazenada. As chamadas contam para o seu uso como qualquer outra.

PEGAR /api/public/v1
curl -H "Autorização: Portador $TERRA_ORB_KEY" \
  "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=5"

Pontos finais

Base: /api/public/v1 — todas as respostas estão em JSON e incluem gerado_em.

PEGAR/api/public/v1/eventos— Eventos

Eventos mesclados das últimas 24h: datas exatas/aproximadas, países emissores e envolvidos, idiomas, número de veículos e artigos, tom, intensidade.

Parâmetros: tópico, emissor=FR, sobre=IR, pesquisa, classificação=mídia|recente|data|intenso, limite≤300

PEGAR/api/public/v1/eventos/{id}— Detalhe do evento

Registro completo: detalhamento da cobertura (propriedade, orientação, país, idioma) e artigos relacionados.

Parâmetros: nenhum

PEGAR/api/public/v1/artigos— Artigos brutos

Artigos das últimas 24h: título, URL canônica, data do evento x data de publicação, país, tema, tom, tipo de veículo (digital/rádio/TV/impresso), rede social.

Parâmetros: q (texto completo), de/para (datas ISO), escopo=live|archive|all (arquivo ≈ 1 ano), tópico, emissor, sobre, idioma=fr, formulário=digital|radio|tv|print, antes=<data ISO> (cursor de paginação), limite≤200

PEGAR/api/public/v1/perguntar— Mecanismo de resposta AI (chave completa)

Pergunta de formato livre: arquivo Terra-OrB e web pública, raciocínio crítico, resumo citado [n], matriz de impacto de 4 domínios, fontes, acompanhamentos.

Parâmetros: GET ?q=...&mode=fast|deep ou POST JSON {pergunta, modo}

PEGAR/api/public/v1/sinais— Sinais iniciais

Eventos detectados com ampla visibilidade: status, confiança, taxa de aceleração, lead time, além de estatísticas globais.

Parâmetros: q (palavras-chave, todas devem corresponder), status=detecte|confirme|repris, limit≤300

PEGAR/api/public/v1/barômetros— Barômetros

Frequência e tom com referência cruzada por tópico, país e idioma: volume, saídas, sentimento, intensidade, tensão, nível de situação.

Parâmetros: nenhum

PEGAR/api/public/v1/cobertura— Cobertura global

Capture o status por país: veículos ativos, artigos recentes, idiomas, status (coberto/fraco/ausente/sem veículo local).

Parâmetros: nenhum

PEGAR/api/public/v1/fontes— Diretório de mídia

Pontos de venda ativos: nome, país, idioma, tipo, canal (feed, página, rede social), propriedade e orientação documentadas, confiabilidade.

Parâmetros: país=FR, idioma=ar, formulário=tv, tipo=mídia|social, antes=<id> (cursor de paginação), limite≤500

Exemplo

curl -H "Autorização: Portador tm_votre_cle" \
  "https://terra-orb.com/api/public/v1/events?about=IR&sort=intensite&limit=20"

Códigos de erro: 401 (chave ausente, desconhecida ou revogada), 402 (créditos esgotados), 400 (parâmetros inválidos), 404 (recurso não encontrado). A paginação de artigos e fontes usa um cursor: envie de volta o valor próximo_cursor no parâmetro antes.