Free News API: Pesquisa de Texto Completo Sobre 21 Milhões de Artigos, 25.000 Editores e 100 Países — Sem Chave de Acesso

Os serviços de notícias API são geralmente vendidos por pedido, ficam atrás de uma chave de acesso e têm um limite de cem chamadas por dia no plano gratuito. Free News API não é nada disso: 21,5 milhões de artigos num período móvel de 90 dias, mais de 25.000 editores, sem chave, sem registo, sem quotas, com uso comercial permitido. Aqui está toda a superfície — pesquisa, estatísticas, tendências, mercados, feeds e MCP — e uma descrição honesta do que os dados podem apresentar de impreciso.

A Natureza do Problema

Pergunte a um agente de IA sobre o que o mundo está a escrever neste momento e ele tem três opções ruins. Pode fazer scraping diretamente nos editores, o que é frágil, lento e tem uma base legal nebulosa. Pode chamar uma API de notícias comercial, o que significa uma conta, uma chave, uma fatura mensal e — em todos os planos gratuitos do mercado — cem pedidos por dia e artigos com atraso de vinte e quatro horas. Ou pode adivinhar com base em dados de formação que pararam há meses.

Free News API remove o preço e a burocracia da segunda opção sem remover a sua capacidade. Um único pedido GET, sem credenciais, sobre um corpus que, no momento da redação, contém 21.557.044 artigos de mais de vinte e cinco mil editores, mantidos numa janela móvel de noventa dias e atualizados continuamente — o artigo mais recente no índice tem tipicamente menos de dois minutos.

Quatro Pontos de Extremidade Principais, e Mais Alguns

O núcleo do serviço consiste em quatro pontos de extremidade GET, todos sob https://freenewsapi.ai, que devolvem JSON em UTF-8 com Access-Control-Allow-Origin: * para que o código do navegador possa chamá-los diretamente, e que registam o tempo do servidor em took_ms.

À volta desse núcleo situam-se mais quatro famílias, cada uma das quais seria um produto autónomo noutro contexto: trends (agrupamento de histórias em tempo real por país), markets (séries de preços alinhadas com o volume de cobertura), crypto sentiment (um bloco Bitcoin de sete pontos finais) e syndication (a mesma pesquisa apresentada como RSS, Atom ou Feed JSON). Todas elas são abordadas abaixo.

curl "https://freenewsapi.ai/v1/search?q=climate+summit&size=2"

{
  "took_ms": 41,
  "total": 1284,
  "total_is_lower_bound": false,
  "size": 2,
  "offset": 0,
  "results": [
    {
      "id": "9c1f8a4b2d3e5f6071829304a5b6c7d8",
      "url": "https://example-news.com/world/climate-summit-opens",
      "title": "Climate summit opens with a call for binding targets",
      "description": "Delegates from 190 countries gathered on Monday ...",
      "published_at": "2026-08-17T09:12:00Z",
      "crawled_at": "2026-08-17T10:48:31Z",
      "host": "example-news.com",
      "sitename": "Example News",
      "country": "GB",
      "country_source": "cctld",
      "lang": "en",
      "tld": "com"
    }
  ]
}

Três campos nesta resposta merecem atenção imediata, porque codificam a honestidade de todo o conjunto de dados. total_is_lower_bound indica quando a contagem de correspondências atingiu o limite de 10 000 e deixou de contar. country_source indica como o país foi determinado — porque, em qualquer conjunto de dados de notícias, uma grande parte dos valores de país são inferências, não factos. E crawled_at é a marca temporal fiável: os editores costumam colocar a data de published_at no passado, mas o tempo de crawl é atribuído pela pipeline e só avança.

Pesquisa: Todos os Parâmetros que Importam

Todos os parâmetros são opcionais. Uma chamada básica devolve os artigos mais recentes no índice.

A consulta

• q Correspondido com o título (peso 3), a descrição (peso 2) e o corpo do artigo. Semântica AND — cada termo deve estar presente, pelo que adicionar uma palavra estreita em vez de alargar o âmbito. Máximo de 500 caracteres.

Os filtros

Os filtros combinam-se com AND entre parâmetros e OR dentro de um parâmetro. Assim, country=DE,AT&lang=de lê-se como "artigos em língua alemã da Alemanha ou da Áustria". Cada um aceita uma lista separada por vírgulas de até cinquenta valores.

Controlo de saída

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=date&size=10"

curl "https://freenewsapi.ai/v1/search?q=merger&country=DE&date=48h&sort=date&size=20"

Contagem antes da pesquisa

O endpoint menos utilizado no serviço é /v1/stats. Frequentemente, a questão útil não é "quais são os artigos", mas "há algo aqui, e onde está". A contagem responde a isto por uma fração do custo — cerca de duzentos tokens contra vários milhares para uma página de resultados —, o que a torna a primeira chamada correta para um agente que decide se vale a pena executar uma pesquisa.

curl "https://freenewsapi.ai/v1/stats?q=earthquake&date=7d"

Retorna contagens por país, idioma, TLD, editor e dia, calculadas sobre todo o conjunto correspondente e não apenas a página atual. É também assim que mede a cobertura antes de confiar nos resultados. A instantâneo sem filtros no momento da redação:

Principais países

Idiomas principais

Inglês 5.513.650 · Espanhol 2.699.457 · Russo 1.785.796 · Turco 1.501.004 · Italiano 992.200 · Alemão 733.677 · Francês 689.136 · Árabe 664.016 · Português 637.607 · Hindi 560.840 · Grego 466.504 · Japonês 427.085 · Vietnamita 385.719 · Romeno 358.766 · Chinês 352.720 · Ucraniano 345.809 · Coreano 335.079 · Persa 268.126 · Polaco 238.904 · Búlgaro 183.204.

Esta distribuição merece uma pausa para reflexão, pois é o oposto do que a maioria dos APIs de notícias lhe apresenta. O corpus habitual, centrado no inglês e nos EUA, não é o que aqui se vê: a Índia supera os Estados Unidos, o turco supera o alemão, e o grego, o vietnamita, o persa e o búlgaro têm todos representações com seis dígitos. Se a sua questão diz respeito à imprensa não inglesa, este é um conjunto de dados materialmente diferente.

Volume

A curva diária em by_day abrange a janela completa de noventa dias. Os dias recentes situam-se na faixa de aproximadamente 400.000 a 700.000 artigos por dia; no início da janela, antes da camada RSS ser adicionada juntamente com a ingestão do arquivo, o volume diário situava-se entre 130.000 e 230.000. Ambas as cifras são visíveis na mesma resposta, que é precisamente o ponto — o serviço mostra-lhe a sua própria progressão em vez de citar uma média de marketing.

Tendências: O que a Imprensa Está Realmente a Cobrir Agora

As pesquisas respondem a "o que foi escrito sobre X". As tendências respondem a uma pergunta diferente e, muitas vezes, melhor: "o que está a acontecer" — sem necessidade de um X.

Um robô agrupa artigos em histórias por país e mantém-nas atualizadas. A cada cinco minutos, novos artigos são ligados a histórias conhecidas pelas suas palavras identificadoras, sem qualquer chamada de modelo; a cada poucas horas, um país passa por uma passagem completa onde um modelo de linguagem lê os títulos e nomeia as histórias do zero. No momento da redação, a camada de tendências abrange 115 países, cada um recalculado nos últimos minutos.

curl "https://freenewsapi.ai/v1/trends?country=US&window=24h&size=5"

{
  "window": "24h",
  "filters": { "country": ["US"], "min_publishers": 1 },
  "trends": [
    {
      "title": "Hurricane Marie threatens Labor Day weather",
      "slug": "hurricane-marie-threatens-labor-day-weather",
      "country": "US",
      "category": "weather",
      "articles": 57,
      "publishers": 24,
      "first_seen": "2026-09-05T19:24:36Z",
      "latest": "2026-09-06T19:00:04Z",
      "url": "https://freenewsapi.ai/trends/us/hurricane-marie-…",
      "headlines": [ … ]
    }
  ]
}

Cada história vem com duas contagens e significam coisas diferentes. articles (artigos) é a intensidade; publishers (editores) é a abrangência. Uma história com 200 artigos de 4 editores é a obsessão de uma redação. Uma história com 60 artigos de 40 editores é um evento. A ordenação padrão é por editores, e min_publishers / min_articles permitem-lhe definir o seu próprio limiar.

As histórias incluem uma categoria de um conjunto fixo: politics, business, markets, tech, sport, health, science, culture, crime, conflict, weather, society.

A janela é uma escolha do leitor, não do robô

Esta é uma decisão de design genuinamente elegante. Cada artigo é armazenado com a sua hora de publicação e associado à respetiva história, pelo que qualquer janela — quinze minutos, uma hora, um dia, uma data específica do calendário — é apenas uma consulta por intervalo sobre os mesmos dados armazenados. Um único cálculo serve todas as janelas simultaneamente. window=15m, window=1h, window=24h, date=2026-09-01, ou um par explícito since/until funcionam contra o mesmo índice sem necessidade de recálculo.

Palavras-chave: as palavras de que a notícia é feita

curl "https://freenewsapi.ai/v1/trends/keywords?country=US&size=8"

Cada palavra-chave é devolvida com o número de histórias distintas que a contêm, o número de artigos que essas histórias incluem e — o aspeto mais interessante — quantas publicações nacionais a utilizam. Esse último número é a diferença entre um evento global e um evento nacional. Uma palavra que aparece em setenta países é uma história mundial; uma palavra que domina a imprensa de um país é uma história doméstica, por mais estrondosa que seja lá.

Quais países estão em direto

curl "https://freenewsapi.ai/v1/trends/countries"

Devolve todos os países monitorizados com a respetiva contagem de histórias em direto e o número de minutos decorridos desde a última recomputação — a Turquia, a Rússia, o Irão, a Grécia, a Índia, a Itália, a Ucrânia, a Roménia, a Argentina, a Alemanha e o Brasil têm atualmente milhares de histórias em direto cada, recomputadas nos últimos dez minutos. E /v1/trends/{cc}/{slug} abre qualquer história única com a respetiva lista completa de artigos.

Mercados vs. Cobertura: Preço num Eixo, Atenção no Outro

Este é o aspeto mais incomum do serviço, e existe porque o corpus torna a sua construção quase gratuita. Colocar uma série de preços ao lado da quantidade de texto escrito sobre esse tema no mesmo período, tudo numa única linha do tempo.

curl "https://freenewsapi.ai/v1/markets"

Quatorze instrumentos são monitorizados, abrangendo quatro classes de ativos:

curl "https://freenewsapi.ai/v1/markets/usd-try?window=30d"

Essa única chamada fornece-te a lira em relação ao dólar e o volume de cobertura da imprensa turca no mesmo período, alinhada hora a hora. A imprensa turca representa o terceiro maior segmento deste corpus, razão pela qual essa combinação produz algo significativo em vez de ruído.

E um bloco completo de sentimento sobre Bitcoin

O Bitcoin tem a sua própria família de sete endpoints, porque é o único instrumento sobre o qual se debate constantemente o tom das notícias e os movimentos de preço, raramente sendo medido:

As etiquetas de sentimento provêm de um modelo de linguagem que analisa artigos recentes sobre criptomoedas a cada cinco minutos, cruzando-os com uma lista de moedas calibrada. O endpoint /v1/btc/correlation com o parâmetro max_shift é o que deve utilizar se alguma vez quiser testar a afirmação de que «as notícias causam o movimento» em vez de a repetir.

A mesma pesquisa, como feed

Três endpoints adicionais aceitam os mesmos parâmetros de pesquisa e apresentam os resultados em formatos de syndication, em vez de JSON:

• GET /v1/rss — RSS 2.0
• GET /v1/atom — Atom 1.0
• GET /v1/feed.json — JSON Feed 1.1

https://freenewsapi.ai/v1/rss?q=semiconductor+export+controls&lang=en&date=7d&sort=date

O que significa que qualquer pesquisa guardada se torna um feed que pode colar num leitor, num nó do n8n, numa integração do Slack, num gatilho do Zapier ou num gerador de sites estáticos — sem código e sem necessidade de chave. É uma funcionalidade pequena que, silenciosamente, elimina uma camada inteira de integração para quem não é programador.

MCP: Vinte e Oito Ferramentas, Duas Camadas

O servidor MCP reside num único URL, utiliza HTTP Streamable (JSON-RPC 2.0 via POST, versão do protocolo 2025-06-18), suporta processamento em lote e — tal como tudo o resto aqui — não exige passo de autorização nem identificador de sessão.

claude mcp add --transport http freenewsapi https://freenewsapi.ai/mcp

Expondo 28 ferramentas em duas camadas deliberadas.

Camada um: seis atalhos que respondem a uma questão completa numa única chamada

Camada dois: cada ponto de extremidade, gerado a partir do próprio serviço

Por baixo dos atalhos, cada ponto de extremidade bruto é exposto como uma ferramenta própria com todos os parâmetros que o API aceita — news_get_search, news_get_stats, news_get_article, news_get_trends, news_get_trends_keywords, news_get_markets_slug, toda a família news_get_btc_*, os renderizadores de feed e news_get_health. Estes são gerados a partir do serviço em tempo real, pelo que não podem divergir do que o API realmente aceita.

Duas ferramentas meta fecham o ciclo: news_list_endpoints devolve o catálogo de tudo o que existe, e news_get executa um GET bruto em qualquer caminho — para que um agente que encontre um ponto de extremidade não coberto pela sua lista de ferramentas ainda possa aceder a ele.

curl "https://freenewsapi.ai/mcp?format=json"

Um único GET, sem handshake, e tem o catálogo completo legível por máquina: servidor, transporte, protocolo, contagem de ferramentas, cada ferramenta com a sua descrição e cada ponto de extremidade com a sua lista de parâmetros.

Construído para ser lido por máquinas

A documentação não é um acessório colado ao API — é uma saída de primeira classe do próprio. O site disponibiliza 665 páginas estáticas, e várias delas existem especificamente para que um modelo nunca tenha de ler HTML:

• /openapi.json O esquema OpenAPI completo.
• /llms.txt Um ficheiro de orientação breve — o que é o serviço, os pontos de acesso (endpoints), como realizar consultas de forma eficaz e os erros.
• /llms-full.txt Toda a documentação num único ficheiro de texto simples, com mais de cem quilobytes, para que um agente possa ingerir o manual inteiro numa única transferência.
• /agents Trinta e nove páginas direcionadas especificamente para criadores de agentes: definições de funções OpenAI prontas a usar, definições de ferramentas Anthropic, prompts de sistema para recuperação de notícias, receitas para RAG, tabelas de custos de tokens e receitas para agentes.
• /agents/models Código para invocação de ferramentas por família de modelos — Qwen, DeepSeek, MiniMax, Kimi, GLM, Doubao, Hunyuan, ERNIE, Yi, Step, GPT, Claude, Gemini, Grok, Mistral, Llama, Command, Nova, Phi, Jamba, Sonar, OpenRouter, Ollama, vLLM.
• /data O que está contido no corpus, a metodologia, o esquema do índice e uma página intitulada Qualidade dos dados que documenta as imprecisões do conjunto de dados.
• /sources Um catálogo navegável de 11 668 editores, filtrável por país, idioma e zona de domínio.
• /compare Páginas de comparação lado a lado com NewsAPI.org, GNews.io, NewsData.io, Mediastack, Currents, TheNewsAPI, NewsCatcher, WorldNewsAPI, Perigon, APITube e FreeNewsAPI.io.

Mais 168 páginas de países, 121 páginas de idiomas e 275 páginas de TLD — uma superfície navegável por cada fatia do corpus, mostrando exatamente o que contém cada uma.

A Origem dos Artigos

Dois caminhos de ingestão alimentam o mesmo índice, e a diferença entre eles é relevante.

O caminho do arquivo

A cada dez minutos, um processo verifica o arquivo CC-NEWS do Common Crawl em busca de novos ficheiros WARC e processa tudo o que ainda não foi visto, utilizando quarenta trabalhadores paralelos. O extrator retira cada artigo do crawl bruto através de uma cascata documentada por campo — e as cascata foram medidas com dados reais, e não assumidas:

Esta figura relativa ao país é a mais honesta, e é por isso que o campo country_source está exposto em todos os artigos: aproximadamente um quinto dos registos não tem qualquer sinal de país fiável e, cerca de um terço dos valores existentes são inferências e não factos. O API indica-te qual é qual, em vez de fingir.

O caminho em tempo real

Um segundo robô consulta os feeds RSS dos editores a cada cinco minutos, numa rotação com pedidos condicionais — um feed que responde com 304 Not Modified tem um custo quase nulo, e o intervalo de consulta de cada feed é ajustado à frequência com que publica realmente. Um jornal que publica cinco artigos por dia não é submetido a consultas excessivas a cada quinze minutos.

Adquire também apenas o que o editor incluiu no feed: título, resumo e texto completo, quando o feed o contém. Não acede ao site do editor para obter mais conteúdo. Esta é uma fronteira deliberada e é a razão pela qual o serviço pode cumprir as promessas que faz na sua página legal voltada para os editores.

E a maquinaria à sua volta

À volta dos dois caminhos de ingestão, existem uma dúzia de outros robôs em agendas: descoberta e sincronização de fontes, resolução de país por domínio, construção e auditoria de tendências, preenchimento de palavras-chave, sentimento das criptomoedas, extração de dados de mercado, catálogo de taxonomias, retenção (a janela de noventa dias é imposta por uma consulta noturna em published_at, e não pela idade do índice), verificação diurna, reavaliação de artigos vazios e um guardião de saúde que reinicia qualquer processo que tenha parado. O corpus reside num cluster Elasticsearch dedicado.

O que este conjunto de dados faz mal

O serviço publica as suas próprias limitações, que é a forma mais rápida de avaliar se se adequa ao seu problema.

• O país é inferido Leia country_source em todos os artigos e adicione strict_country=true quando estiver a contar por país, em vez de apenas a navegar.
• published_at é fornecido pelo editor A alteração da data de publicação é comum. Ordene por crawled quando estiver a consultar para ver o que é novo.
• total está limitado a 10.000 Por questões de velocidade. total_is_lower_bound indica-lhe quando atinge o limite.
• Sem extração de sentimento ou entidades Fora do bloco Bitcoin, os artigos não têm pontuação de sentimento nem entidades nomeadas. Isso não está no âmbito de aplicação.
• Noventa dias e não mais Não existe um arquivo mais antigo. Se precisa de 2019, esta não é a ferramenta adequada.
• Sem SLA É gratuito. Também é monitorado e protegido, mas nada é prometido por escrito.
• O texto pertence aos editores Cada resposta inclui o URL original, e espera-se que os utilizadores liguem a ele.

Utilização Eficiente: Custos, Paginação e Erros

Disciplina de tokens

Para um agente, o tamanho da resposta é o custo real. A forma documentada:

Vinte artigos com full_text=true correspondem a aproximadamente 40 000 tokens. O padrão recomendado é sempre o mesmo: contar, analisar e, em seguida, obter os conteúdos completos apenas para os poucos que precisa.

Avançar para além do limite

O offset atinge o limite em 9 900. Para percorrer um conjunto de dados grande, não lute contra o teto — divida por tempo em vez disso. Faça um ciclo dia a dia ou hora a hora numa consulta com muitos resultados, utilizando from/to e sort=date. A documentação tem uma página dedicada sobre como percorrer um dia inteiro.

Erros

O contrato é claro e fácil de implementar: 4xx significa que o pedido está errado — corrija-o, não tente novamente. 5xx significa que o serviço está indisponível — reduza a frequência. 429 significa que deve reduzir a velocidade e tentar novamente. Parâmetros de consulta desconhecidos são ignorados em vez de rejeitados, pelo que adicionar um campo nunca irá quebrar um cliente existente.

Identifique-se (Opcional, e genuinamente opcional)

Sem uma chave, não há forma de identificar quem faz o pedido. A cortesia recomendada é incluir um cabeçalho que indique o seu agente, a framework através da qual opera e o modelo que o impulsiona:

X-Agent: agent_name=<agent>; software=<langchain|llamaindex|n8n|claude-desktop|cursor|openai-assistants|crewai|custom>; model=<model>; version=<v>; purpose=<rag|monitoring|research|digest>; contact=<url or mailto>
User-Agent: <agent>/<version> (+<contact url>)

Os mesmos valores funcionam como parâmetros de consulta simples, o que geralmente é mais fácil:

https://freenewsapi.ai/v1/search?q=climate&agent_name=newsbot&software=langchain&model=gpt-4o

As chaves desconhecidas são ignoradas, pelo que enviar chaves adicionais é sempre seguro. Nada é validado, nada é limitado por não ser incluído, e a única instrução é firme: não coloque nunca dados pessoais dos utilizadores finais nestes campos.

Contra as notícias pagas APIs

As páginas de comparação no site cobrem onze concorrentes individualmente. As diferenças estruturais que persistem em todas elas:

O que os serviços pagos ainda lhe oferecem e isto não: pontuações de sentimento e extração de entidades como campos padrão, arquivos que remontam a vários anos e um contrato com uma SLA por trás. Isso é real, e se precisar disso, deve comprar esses serviços.

Receitas

Um monitor de país em tempo real

curl "https://freenewsapi.ai/v1/search?country=UA&lang=uk&date=today&sort=crawled&size=50"

Esta notícia é global ou doméstica?

curl "https://freenewsapi.ai/v1/trends/keywords?size=30"
# read `countries` on each keyword: 1 country = domestic, 70 = world event

Ancorar um modelo na cobertura atual a baixo custo

# 1. count first
curl "https://freenewsapi.ai/v1/stats?q=semiconductor+export+controls&date=7d"
# 2. scan metadata
curl "https://freenewsapi.ai/v1/search?q=semiconductor+export+controls&date=7d&lang=en&size=20&sort=relevance"
# 3. fetch bodies for the three you picked
curl "https://freenewsapi.ai/v1/article?url=<exact-url>&full_text=true"

A cobertura antecipa o preço?

curl "https://freenewsapi.ai/v1/btc/correlation?interval=hour&max_shift=12"

Converter uma pesquisa guardada num feed

https://freenewsapi.ai/v1/rss?q=central+bank+rate&lang=en&date=24h&sort=date&size=50

Encontre os veículos que importam num mercado

curl "https://freenewsapi.ai/v1/stats?country=BR&date=30d&top=50"
# the `hosts` block is a ranked publisher list for that slice

Versão Curta

Free News API é uma pesquisa de texto completo sobre 21,5 milhões de artigos de notícias de mais de 25 000 editores em 100 países e cerca de 100 idiomas, numa janela móvel de noventa dias, atualizada continuamente, sem chave de API, sem registo e sem limite de quotas além de um limite de taxa por IP. Sobre a pesquisa, destacam-se o agrupamento de notícias em tempo real por país em 115 países, a análise de palavras-chave que separa eventos mundiais de eventos nacionais, quatorze instrumentos de mercado plotados contra o volume de cobertura, um bloco de sentimento do Bitcoin com sete endpoints, a sindicacao RSS/Atom/JSON para qualquer consulta e um servidor MCP com 28 ferramentas gerado a partir do próprio serviço.

Documenta as suas próprias taxas de erro, expõe como cada valor de país foi derivado e publica uma página sobre onde os dados falham. Para um agente que precisa de saber o que o mundo está a dizer — em turco, em grego, em hindi, agora mesmo — essa combinação é difícil de encontrar a qualquer preço, e esta é gratuita.

A pesquisa é AND (E) entre todos os termos. Utilize 2–5 palavras-chave, não uma pergunta em linguagem natural.

Free News API, sobre como consultar bem

Comece aqui: freenewsapi.ai · MCP em freenewsapi.ai/mcp · o manual inteiro num único ficheiro em /llms-full.txt.