API de Notícias Econômicas
Manchetes do Fed, CPI, inflação e decisões de juros da Reuters, AP, CNBC e mais de 100 outras fontes, filtradas por uma única consulta e entregues ao seu sistema via REST, WebSocket ou webhooks.
Payload de demonstração do produto
O que um artigo macro carrega
Obtido ao vivo com a consulta em que esta página se baseia:
query: "federal reserve" OR FOMC OR CPI OR inflation
categories: economy{
"title": "America In Focus: US employers unexpectedly cut 23,000 jobs; mortgage rates rise again",
"link": "https://apnews.com/article/inflation-economy-trump-iran-unemployment-7e17e0d7b7baf952878274ced568a2f8",
"source": "apnews.com",
"publishDate": "2026-08-08T14:10:06.000Z",
"language": "en",
"sentiment": "negative",
"confidence": 0.7371397614479065,
"categories": ["business", "economy", "markets"],
"countries": ["US"],
"summary": "U.S. employers unexpectedly cut 23,000 jobs last month, and Labor Department revisions shaved 103,000 jobs off payrolls in May and June.",
"companies": []
}Payload abreviado: o array images é omitido. companies está vazio neste artigo porque um relatório de empregos não menciona nenhuma empresa listada; quando um artigo macro menciona, cada entidade traz ticker, bolsa (código MIC), ISIN, setor, indústria e listagens cruzadas. Uma matéria semanal de mercados da Benzinga retornada pela mesma consulta ao vivo estava marcada com PLTR, AMAT, TTD, ZBRA, COHR e DVA com todos esses campos. Referência completa de campos na documentação.
Alerta macro
O alerta que as mesas de macro continuam construindo manualmente
O alerta macro é o padrão que os usuários pagantes da finlight constroem repetidamente, de forma independente e quase idêntica: uma cadeia OR sobre Fed, FOMC, CPI, PPI, folha de pagamento, PIB, inflação e termos de tarifas, filtrada para notícias de economia. As equipes convergem para os mesmos critérios sem nunca terem visto as consultas umas das outras. Esta página oferece esse padrão como ponto de partida em vez de um campo de consulta em branco:
{
"name": "Macro news alert",
"query": "\"federal reserve\" OR FOMC OR CPI OR inflation",
"categories": ["economy"],
"url": "https://your-endpoint.example.com/macro-news"
}Quando um artigo corresponde, este POST chega ao seu endpoint. Os cabeçalhos e o corpo abaixo são de uma entrega real capturada:
POST /macro-news HTTP/1.1
Content-Type: application/json
X-Webhook-Signature: sha256=01c4d3b9...913527fd
X-Webhook-Timestamp: 2026-08-08T20:40:58.736Z{
"link": "https://apnews.com/article/inflation-economy-trump-iran-unemployment-7e17e0d7b7baf952878274ced568a2f8",
"source": "apnews.com",
"title": "America In Focus: US employers unexpectedly cut 23,000 jobs; mortgage rates rise again",
"images": ["..."],
"summary": "U.S. employers unexpectedly cut 23,000 jobs last month, and Labor Department revisions shaved 103,000 jobs off payrolls in May and June.",
"language": "en",
"publishDate": "2026-08-08T14:10:06.000Z",
"createdAt": "2026-08-08T14:11:52.000Z",
"categories": ["business", "economy", "markets"],
"sentiment": "negative",
"confidence": 0.7371397614479065,
"countries": ["US"],
"content": "...",
"isUpdate": false,
"revisedDate": "2026-08-08T14:10:06.000Z"
}Payload abreviado: images e content estão encurtados. Cada entrega é assinada com HMAC-SHA256 (X-Webhook-Signature) e traz um timestamp de entrega; entregas com falha são reenviadas automaticamente com backoff exponencial. Webhooks estão disponíveis nos planos que os incluem; veja preços.
Uma consulta, três caminhos de entrega.
A mesma consulta alimenta os três: o endpoint REST para busca e backfill, o stream de WebSocket para uma conexão persistente, e os webhooks para push naquilo que você já usa. Defina o feed de notícias financeiras uma vez e consuma onde seu sistema precisar. Se o consumidor for um sistema de trading reagindo a manchetes macro, a página de Sistemas de Trading cobre a configuração de dual stream feita para isso.
Código pronto para copiar e colar
A consulta macro, executável
A mesma cadeia OR contra a API REST. Só falta a chave de API.
import { FinlightApi } from 'finlight-client'
const api = new FinlightApi({ apiKey: 'YOUR_API_KEY' })
const res = await api.articles.fetchArticles({
query: '"federal reserve" OR FOMC OR CPI OR inflation',
categories: ['economy'],
includeEntities: true,
pageSize: 20,
})
for (const a of res.articles) {
console.log(a.publishDate, a.sentiment, a.confidence, a.title)
}from finlight_client import FinlightApi
from finlight_client.models import ApiConfig, GetArticlesParams
api = FinlightApi(config=ApiConfig(api_key="YOUR_API_KEY"))
res = api.articles.fetch_articles(
params=GetArticlesParams(
query='"federal reserve" OR FOMC OR CPI OR inflation',
categories=["economy"],
include_entities=True,
page_size=20,
)
)
for a in res["articles"]:
print(a["publishDate"], a["sentiment"], a["confidence"], a["title"])Instale com npm install finlight-client ou pip install finlight-client. A linguagem de consulta suporta lógica booleana, frases exatas e filtros de campo, então a cadeia se estende como essas equipes estenderam a delas: adicione termos de BCE, BOJ, folha de pagamento, PIB ou tarifas conforme sua mesa precisar. Para critérios voltados a tarifas e sanções, veja a API de Notícias Geopolíticas. Referência completa de consultas na documentação, visão geral do produto na News API.
O que a finlight não faz
A finlight não é um calendário econômico: não fornece valores de indicadores, números de consenso ou previsão, nem datas de divulgação. O conjunto de ferramentas comum combina um site gratuito de datas de divulgação (Forex Factory, Trading Economics) com uma API de notícias genérica ou scraping RSS artesanal, e depois costura alertas macro a partir dos dois. A finlight substitui a segunda metade desse conjunto: observar Reuters, AP, CNBC, Yahoo Finance, the Guardian e mais de 100 outras fontes em busca de manchetes do Fed, CPI, inflação e decisões de juros, filtrá-las por categoria e palavra-chave, e conectar o resultado a um alerta. Se valores de indicadores e o momento das divulgações são o que você precisa, use um produto de dados para essa metade. Se a metade de notícias é a parte que você continua reconstruindo, essa é a parte que esta API substitui.
Perguntas frequentes
API de Notícias Econômicas: Perguntas Frequentes
Tudo o que os desenvolvedores perguntam antes de montar um alerta de notícias macro.
Há um plano gratuito para testes, e os planos pagos começam em $29/mês. Os planos diferem em volume de requisições, acesso em tempo real, webhooks e dados históricos. Preços e limites atuais estão na página de preços.
Ainda Tem Dúvidas?
Nossa equipe de suporte focada em desenvolvedores está aqui para ajudá-lo a integrar e escalar.
Configure o alerta antes da próxima divulgação
O próximo dado de CPI, relatório de empregos ou decisão de juros já está agendado; seu alerta deveria existir antes que ele chegue. Obtenha uma chave, crie o alerta macro acima e avalie o feed com uma divulgação ao vivo em vez de uma demonstração.