Free News API: Busca de texto completo por mais de 21 milhões de artigos, 25 mil editais e 100 países — sem necessidade de nenhuma chave

Os serviços de notícias API geralmente são vendidos por solicitação, ficam atrás de uma chave e têm um limite de cem chamadas por dia no plano gratuito. Free News API não faz nenhuma dessas coisas: 21,5 milhões de artigos em uma janela móvel de 90 dias, mais de 25 mil editais, sem chave, sem cadastro, sem cota e uso comercial permitido. Aqui está toda a superfície — busca, estatísticas, tendências, mercados, feeds e MCP — e uma análise honesta do que os dados podem apresentar de impreciso.

A forma do problema

Pergunte a um agente de IA sobre o que o mundo está escrevendo agora e ele terá três opções ruins. Ele pode fazer scraping diretamente dos editais, o que é frágil, lento e tem base legal nebulosa. Ele pode chamar um serviço comercial de notícias API, o que significa uma conta, uma chave, uma fatura mensal e — em todos os planos gratuitos do mercado — cem solicitações por dia e artigos com atraso de vinte e quatro horas. Ou ele pode adivinhar com base em dados de treinamento que pararam há meses.

Free News API remove o preço e a burocracia da segunda opção sem remover sua capacidade. Uma única solicitação GET, sem credenciais, sobre um corpus que, no momento da escrita, contém 21.557.044 artigos de mais de vinte e cinco mil editais, mantidos em uma janela móvel de noventa dias e atualizados continuamente — o artigo mais recente no índice geralmente tem menos de dois minutos.

Quatro Endpoints Principais, e Mais Alguma Coisa

O núcleo do serviço são quatro endpoints GET, todos em https://freenewsapi.ai, todos retornando JSON em UTF-8 com Access-Control-Allow-Origin: * para que o código do navegador possa chamá-los diretamente, e todos relatando o tempo do servidor em took_ms.

Ao redor desse núcleo, situam-se mais quatro famílias, cada uma das quais seria um produto independente em outro contexto: tendências (agrupamento de notícias em tempo real por país), mercados (séries de preços alinhadas ao volume de cobertura), sentimento cripto (um bloco do Bitcoin com sete pontos finais) e sindicação (a mesma pesquisa renderizada 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 nessa resposta merecem atenção imediata, pois 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 parou de contar. country_source informa 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 fatos. E crawled_at é o carimbo de data/hora confiável: os editores costumam retroceder a data de published_at, mas o tempo de rastreamento é atribuído pelo pipeline e só avança.

Pesquisa: Cada Parâmetro que Importa

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

A consulta

• q Correspondência contra título (peso 3), descrição (peso 2) e o corpo do artigo. Semântica AND — cada termo deve estar presente, portanto, adicionar uma palavra restringe em vez de ampliar. Máximo de 500 caracteres.

Os filtros

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

Controle 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 de pesquisar

O endpoint menos utilizado no serviço é /v1/stats. Frequentemente, a pergunta útil não é "quais são os artigos", mas "há algo aqui e onde está". Contar os resultados responde a isso por uma fração do custo — cerca de duzentos tokens contra vários milhares para uma página de resultados —, tornando-o 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"

Ele retorna contagens por país, idioma, TLD, editor e dia, calculadas sobre todo o conjunto correspondente, e não apenas a página atual. Isso também é como você mede a cobertura antes de confiar nos resultados. A instantâneo sem filtros no momento da escrita:

Principais países

Principais idiomas

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 · Polonês 238.904 · Búlgaro 183.204.

Essa distribuição vale a pena ser observada por um momento, pois é o oposto do que a maioria dos APIs de notícias oferece. O corpus típico, com prioridade para o inglês e para os EUA, não é o que temos aqui: a Índia supera os Estados Unidos, o turco supera o alemão, e grego, vietnamita, persa e búlgaro todos têm representação com seis dígitos. Se sua pergunta é sobre uma imprensa não inglesa, este é um conjunto de dados materialmente diferente.

Volume

A curva diária em by_day cobre a janela completa de noventa dias. Os dias recentes ficam na faixa de aproximadamente 400.000 a 700.000 artigos por dia; no início da janela, antes que a camada RSS fosse adicionada junto com a ingestão do arquivo, o volume diário variava entre 130.000 e 230.000. Ambas as cifras são visíveis na mesma resposta, que é o ponto principal — o serviço mostra seu próprio crescimento, em vez de citar uma média de marketing.

Tendências: O que a Imprensa Está Cobrindo Agora

Busca responde "o que foi escrito sobre X". Tendências responde a uma pergunta diferente e muitas vezes melhor: "o que está acontecendo" — sem necessidade de um X.

Um robô agrupa artigos em histórias por país e os mantém atualizados. A cada cinco minutos, novos artigos são vinculados a histórias conhecidas por suas palavras-chave, sem nenhuma chamada de modelo; a cada poucas horas, um país passa por uma verificação completa onde um modelo de linguagem lê os títulos e nomeia as histórias do zero. No momento da escrita, a camada de tendências cobre 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 elas significam coisas diferentes. articles é intensidade; publishers é abrangência. Uma história com 200 artigos de 4 veículos é a obsessão de uma redação. Uma história com 60 artigos de 40 veículos é um evento. A ordenação padrão é por publishers, e min_publishers / min_articles permitem que você defina o limite você mesmo.

As notícias recebem 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 seu horário de publicação e vinculado à sua notícia, portanto qualquer janela — quinze minutos, uma hora, um dia, uma data específica do calendário — é apenas uma consulta de intervalo sobre os mesmos dados armazenados. Um único cálculo atende 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 sobre as quais a notícia é construída

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

Cada palavra-chave retorna quantas notícias distintas a contêm, quantos artigos essas notícias possuem e — a parte mais interessante — quantas redações nacionais a utilizam. Esse último número é a diferença entre um evento global e um doméstico. Uma palavra que aparece em setenta países é uma notícia mundial; uma palavra que domina a imprensa de um único país é uma notícia doméstica, por mais barulhenta que seja lá.

Quais países estão em tempo real

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

Retorna todos os países rastreados com sua contagem de notícias em tempo real e há quantos minutos foram recomputados — Turquia, Rússia, Irã, Grécia, Índia, Itália, Ucrânia, Romênia, Argentina, Alemanha e Brasil atualmente possuem milhares de notícias em tempo real cada, recomputadas nos últimos dez minutos. E /v1/trends/{cc}/{slug} abre qualquer notícia única com sua lista completa de artigos.

Mercados vs. Cobertura: Preço em um eixo, Atenção no outro

Esta é a característica mais incomum do serviço, e existe porque o corpus torna quase gratuito construí-la. Coloque uma série de preços ao lado de quanto o mundo escreveu sobre aquilo nas mesmas horas, em uma única linha do tempo.

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

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

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

Essa única chamada fornece a cotação da lira em relação ao dólar e o volume de cobertura da imprensa turca no mesmo período, alinhadas hora a hora. A imprensa turca corresponde ao terceiro maior segmento desse corpus, o que explica exatamente por que essa combinação produz dados significativos em vez de ruído.

E um bloco completo de sentimento sobre Bitcoin

O Bitcoin ganha sua própria família de sete endpoints, pois é o único ativo sobre o qual o tom das notícias e os movimentos de preço são constantemente debatidos e raramente medidos:

As etiquetas de sentimento são geradas por um modelo de linguagem que analisa artigos recentes sobre criptomoedas a cada cinco minutos, cruzando-os com uma lista de moedas calibrada. A rota /v1/btc/correlation, com o parâmetro max_shift, é a ideal para quem deseja testar a afirmação de que "as notícias causam os movimentos" em vez de apenas repeti-la.

A mesma busca, como feed

Três endpoints adicionais utilizam os mesmos parâmetros de busca 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

Isso significa que qualquer busca salva se torna um feed que você pode colar em um leitor, em um nó do n8n, em uma integração do Slack, em um gatilho do Zapier ou em um gerador de sites estáticos — sem código e sem necessidade de chave. É um recurso discreto que elimina silenciosamente uma camada inteira de integração para quem não é programador.

MCP: Vinte e oito ferramentas, duas camadas

O servidor MCP está localizado em um único URL, utiliza HTTP Streamable (JSON-RPC 2.0 sobre POST, versão do protocolo 2025-06-18), suporta loteamento e, assim como todo o restante aqui, não exige etapa de autorização nem possui ID de sessão.

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

Ele expõe 28 ferramentas em duas camadas deliberadas.

Camada um: seis atalhos que respondem a uma pergunta completa em uma única chamada

Camada dois: cada endpoint, gerado a partir do próprio serviço

Abaixo dos atalhos, cada endpoint bruto é exposto como sua própria ferramenta 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. Eles são gerados a partir do serviço em tempo real, portanto, não podem divergir do que o API realmente aceita.

Duas ferramentas meta fecham o ciclo: news_list_endpoints retorna 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 endpoint não coberto por sua lista de ferramentas ainda possa acessá-lo.

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

Um único GET, sem aperto de mão, e você tem o catálogo inteiro legível por máquinas: servidor, transporte, protocolo, contagem de ferramentas, cada ferramenta com sua descrição e cada endpoint com sua lista de parâmetros.

Construído para ser lido por máquinas

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

• /openapi.json O esquema OpenAPI completo.
• /llms.txt Um arquivo de orientação curto — o que é o serviço, os endpoints, como fazer consultas de forma eficaz e os erros.
• /llms-full.txt Toda a documentação em um único arquivo de texto puro, com mais de cem kilobytes, para que um agente possa ingerir todo o manual em uma única busca.
• /agents Trinta e nove páginas direcionadas especificamente a criadores de agentes: definições de função prontas para OpenAI, definições de uso de ferramentas para Anthropic, prompts de sistema para recuperação de notícias, receitas de RAG, tabelas de custos de tokens e receitas para agentes.
• /agents/models Código para chamada 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á dentro do corpus, a metodologia, o esquema do índice e uma página intitulada Qualidade dos dados que documenta onde o conjunto de dados falha.
• /sources Um catálogo navegável com 11.668 editores, filtrável por país, idioma e zona de domínio.
• /compare Páginas lado a lado contra 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 fatia do corpus, cada uma mostrando o que realmente está contido nelas.

De onde vêm os 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, uma tarefa verifica o arquivo CC-NEWS do Common Crawl em busca de novos arquivos WARC e processa tudo o que ainda não foi visto, usando quarenta workers paralelos. O extrator recupera cada artigo do raw crawl com uma cascata documentada por campo — e as cascata foram medidas contra dados reais, e não assumidas:

Esse dado sobre o país é o mais honesto, e é por isso que o campo country_source é exposto em cada artigo: aproximadamente um quinto dos registros não possui nenhum sinal confiável de país, e cerca de um terço dos valores que existem são inferências, e não fatos. O API indica qual é qual, em vez de fingir que não.

O caminho em tempo real

Um segundo robô consulta os feeds do editor RSS a cada cinco minutos, em um ciclo com solicitações condicionais — um feed que responde 304 Not Modified custa quase nada, e o intervalo de consulta de cada feed é ajustado à frequência com que ele realmente publica. Um veículo que publica cinco matérias por dia não é submetido a consultas a cada quinze minutos.

Ele também captura apenas o que o editor incluiu no feed: título, resumo e texto completo, quando o feed os contém. Ele não acessa o site do editor para buscar mais informações. Essa é uma fronteira deliberada, e é a razão pela qual o serviço pode fazer as promessas que faz em sua página legal voltada para editores.

E a infraestrutura ao redor deles

Ao redor dos dois caminhos de ingestão, há uma dúzia de outros robôs em escalas variadas: 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 de criptomoedas, consultas de mercado, catálogo de taxonomias, retenção (a janela de noventa dias é aplicada por uma consulta noturna em published_at, e não pela idade do índice), verificação diária, reanálise de artigos vazios e um guardião de saúde que reinicia qualquer processo que tenha parado. O corpus reside em um cluster dedicado do Elasticsearch.

O que Este Conjunto de Dados Faz Errado

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

• O país é inferido Leia country_source em cada artigo e adicione strict_country=true quando estiver contando por país, em vez de apenas navegando.
• published_at é fornecido pelo editor A datação retroativa é comum. Ordene por crawled quando estiver consultando para ver o que é novo.
• total é limitado a 10.000 Para velocidade. total_is_lower_bound indica quando você atinge o limite.
• Sem extração de sentimento ou entidades Fora do bloco de Bitcoin, os artigos não possuem pontuação de sentimento nem entidades nomeadas. Isso não está no escopo.
• Noventa dias e não mais Não há um arquivo mais antigo. Se você 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 chamadores façam um link de volta para ele.

Uso Eficiente: Custo, Paginação e Erros

Disciplina de tokens

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

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

Paginação além do limite

O offset para em 9.900. Para percorrer um conjunto grande, não enfrente o limite — fatione por tempo. Faça um loop dia a dia, ou hora a hora em consultas com alto volume, usando from/to e sort=date. A documentação possui uma página dedicada sobre como percorrer um dia inteiro.

Erros

O contrato é direto e fácil de implementar: 4xx significa que a solicitação está errada — corrija-a, não tente novamente. 5xx significa que o serviço está fora do ar — aguarde. 429 significa reduzir a velocidade e tentar novamente. Parâmetros de consulta desconhecidos são ignorados em vez de rejeitados, portanto, adicionar um campo nunca quebrará um cliente existente.

Identifique-se (Opcional e genuinamente opcional)

Sem uma chave, não há como identificar o cliente. A cortesia sugerida é um cabeçalho que nomeie seu agente, o framework pelo qual ele opera e o modelo que o alimenta:

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

Chaves desconhecidas são ignoradas, portanto, enviar chaves extras é sempre seguro. Nada é validado, nada é limitado por sua omissão, e a única instrução é firme: nunca coloque dados pessoais do usuário final nesses 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 todos eles:

O que os serviços pagos ainda oferecem e este não oferece: pontuações de sentimento e extração de entidades como campos padrão, arquivos que remontam a vários anos e um contrato com um SLA por trás. Esses recursos são reais e, se você precisar deles, deve comprá-los.

Receitas

Um monitor de países 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 de forma econômica

# 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 influencia o preço?

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

Transformar uma busca salva em um feed

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

Encontre os veículos que importam em um 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 busca de texto completo sobre 21,5 milhões de artigos de notícias de mais de 25.000 publicadores em 100 países e aproximadamente 100 idiomas, em uma janela móvel de noventa dias, atualizada continuamente, sem necessidade de chave, cadastro ou cota, além de um limite de taxa por IP. Além da busca, há agrupamento de notícias em tempo real por país em 115 países, análise de palavras-chave que separa eventos mundiais dos domésticos, quatorze instrumentos de mercado plotados contra o volume de cobertura, um bloco de sentimento do Bitcoin com sete endpoints, syndication RSS/Atom/JSON para qualquer consulta e um servidor MCP com 28 ferramentas gerado a partir do próprio serviço.

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

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

Free News API, sobre como consultá-lo bem

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