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 emtermos_de_consulta. - · Usar
/artigospara cobertura real da imprensa (texto completo, data, domínio de origem)./sinaisé um feed global de alerta precoce: sempre passeqpara manter apenas sinais correspondentes. - · Consulta
/artigos,/eventose/sinaisem 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 mercado | Seu preço | Volume | Terra-OrB |
|---|---|---|---|
| Padrão TheNewsAPI/MediaStack | US$ 99/mês | 10.000 a 30.000 solicitações | ≈ $ 72 / mês |
| MediaStack Profissional | US$ 249/mês | 50.000 solicitações | ≈ $ 184 / mês |
| Negócios da NewsAPI | US$ 449/mês | 250.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.
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.
/api/public/v1/eventos— EventosEventos 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
/api/public/v1/eventos/{id}— Detalhe do eventoRegistro completo: detalhamento da cobertura (propriedade, orientação, país, idioma) e artigos relacionados.
Parâmetros: nenhum
/api/public/v1/artigos— Artigos brutosArtigos 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
/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}
/api/public/v1/sinais— Sinais iniciaisEventos 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
/api/public/v1/barômetros— BarômetrosFrequê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
/api/public/v1/cobertura— Cobertura globalCapture o status por país: veículos ativos, artigos recentes, idiomas, status (coberto/fraco/ausente/sem veículo local).
Parâmetros: nenhum
/api/public/v1/fontes— Diretório de mídiaPontos 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.