--- title: "Notícias de empresas" method: GET path: "/api/v2/news" tags: ["Notícias"] --- # Notícias de empresas `GET /api/v2/news` ## Request - Base URL: `https://brapi.dev` - URL: `https://brapi.dev/api/v2/news` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Notícias sobre empresas e ativos da B3: resultados, proventos, fusões, captações, recomendações e outros fatos. Os títulos, resumos e matérias são escritos por inteligência artificial a partir das matérias listadas em `sources`. Cada notícia junta as matérias de vários veículos sobre o mesmo fato. Use `tickers` para ver as notícias de ativos específicos. Um ticker de ação também traz as notícias das outras classes da mesma empresa. As notícias vêm da mais recente para a mais antiga. Para a próxima página, envie `nextCursor` no parâmetro `cursor`. Disponível no plano Pro. ## Query parameters - `tickers` string: Tickers separados por vírgula. Máximo de 20. Um ticker de ação também traz as notícias das outras classes da mesma empresa (PETR4 inclui PETR3). Sem `tickers`, traz notícias de todas as empresas. - `eventTypes` 'earnings' | 'dividends' | 'guidance' | 'mna' | 'financing' | 'buyback' | 'rating' | 'analyst' | 'management' | 'legal_regulatory' | 'operations' | 'market_move' | 'macro' | 'other': Tipos de evento separados por vírgula: `earnings` (resultados), `dividends` (proventos), `guidance` (projeções), `mna` (fusões e aquisições), `financing` (captações e dívida), `buyback` (recompra), `rating` (nota de crédito), `analyst` (recomendações), `management` (gestão), `legal_regulatory` (jurídico e regulação), `operations` (operações), `market_move` (movimento de mercado), `macro` (macroeconomia), `other` (outros). - `sentiment` 'positive' | 'negative' | 'neutral' | 'mixed': Sentimento da notícia, separado por vírgula: `positive`, `negative`, `neutral` ou `mixed`. - `minImportance` integer: Importância mínima, de 1 (pequena) a 5 (move o mercado). Padrão: 1. - `from` string: Publicadas a partir desta data (`YYYY-MM-DD`) ou data e hora ISO 8601. Sem fuso, vale o horário de Brasília. - `to` string: Publicadas até esta data (inclui o dia inteiro) ou até esta data e hora ISO 8601. Sem fuso, vale o horário de Brasília. - `limit` integer: Máximo de notícias por página. Padrão: 20. - `cursor` string: Cursor da próxima página. Use o valor de `nextCursor` da resposta anterior, com os mesmos filtros. - `includeArticle` 'true' | 'false': `true` inclui a matéria completa em Markdown no campo `article`. Padrão: `false`. ## Response `200` Notícias encontradas. - NewsListResponse - `results` NewsStory[], required - `id` string, uuid, required - `slug` string, required - `url` string, required: Página da notícia na brapi. - `title` string, required - `description` string, nullable, required: Uma frase sobre a notícia. - `summary` string, required: Resumo da notícia. - `image` NewsImage, nullable, required: Imagem da notícia. Só as notícias mais importantes têm imagem; as outras vêm com `null`. - `url` string, required: Imagem em WebP, 1600 px de largura. - `smallUrl` string, required: Imagem em WebP, 800 px de largura. - `width` integer, required - `height` integer, required - `alt` string, required: Descrição da imagem. - `source` 'commons' | 'ai', required: `commons` para foto do Wikimedia Commons. `ai` para imagem ilustrativa gerada por IA. - `credit` string, nullable, required: Autor da foto. `null` para imagem gerada por IA. - `license` string, nullable, required - `licenseUrl` string, nullable, required - `sourceUrl` string, nullable, required: Página do arquivo no Wikimedia Commons. - `keyPoints` string[], required: Pontos principais. - `article` string, nullable, required: Matéria completa em Markdown. Vem só com `includeArticle=true` ou na consulta de uma notícia. `null` enquanto a matéria não foi escrita. - `eventType` 'earnings' | 'dividends' | 'guidance' | 'mna' | 'financing' | 'buyback' | 'rating' | 'analyst' | 'management' | 'legal_regulatory' | 'operations' | 'market_move' | 'macro' | 'other', required - `scope` 'company' | 'market', required: `company` para notícias de empresas e ativos. `market` para economia, juros, câmbio, política e o índice. - `sentiment` object, required: Sentimento da notícia. - `label` 'positive' | 'negative' | 'neutral' | 'mixed', required - `score` number, required: De -1 (muito negativa) a 1 (muito positiva). - `importance` integer, required: De 1 (pequena) a 5 (move o mercado). - `topics` string[], required: Temas da notícia. - `assets` NewsAsset[], required: Ativos sobre os quais a notícia trata ou que ela afeta. - `ticker` string, required: Ticker principal do ativo. - `tickers` string[], required: Todos os tickers do ativo citados na notícia. - `name` string, required - `type` 'stock' | 'fii' | 'fiagro' | 'fiinfra' | 'fidc' | 'fip' | 'etf' | 'bdr' | 'index' | 'currency', required: Tipo do ativo: `stock`, `fii`, `fiagro`, `fiinfra`, `fidc`, `fip`, `etf`, `bdr`, `index` ou `currency`. - `relevance` 'primary' | 'secondary', required: `primary` quando a notícia é sobre o ativo. `secondary` quando o ativo é afetado. - `sentiment` 'positive' | 'negative' | 'neutral', nullable, required: Efeito provável da notícia no ativo. - `reason` string, nullable, required: Por que a notícia afeta o ativo. - `sources` NewsSource[], required: Matérias dos veículos usadas para escrever a notícia. - `name` string, required: Nome do veículo. - `title` string, required: Título da matéria no veículo. - `url` string, required: Link da matéria no veículo. - `publishedAt` string, required: Data e hora de publicação no veículo, em ISO 8601. - `publishedAt` string, required: Data e hora da primeira publicação, em ISO 8601. - `updatedAt` string, required: Última mudança no conteúdo, em ISO 8601. - `articleWrittenAt` string, nullable, required: Quando a matéria foi escrita, em ISO 8601. - `nextCursor` string, nullable, required: Cursor da próxima página, para o parâmetro `cursor`. `null` na última página. - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601. - `took` integer, required: Tempo de processamento, em milissegundos. ## Other responses - `400`: Requisição inválida. Confira os parâmetros. - `401`: Token ausente ou inválido. - `403`: O plano não inclui este recurso ou parâmetro. - `404`: Nenhum dado encontrado para o pedido. - `429`: Limite de requisições excedido. - `500`: Erro interno do servidor. - `503`: Serviço temporariamente indisponível. Tente de novo em alguns minutos. ## Changes - **2026-11-07** `1ff668e5fe6e`: 1 info - endpoint added [Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/news/get.md) --- [API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/662d64c3bda7?raw)