---
title: "Notícia"
method: GET
path: "/api/v2/news/{id}"
tags: ["Notícias"]
---

# Notícia

`GET /api/v2/news/{id}`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/news/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/docs/api/v2/news/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Uma notícia pelo ID ou pelo slug, com a matéria completa em Markdown e até 6 notícias relacionadas. 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. Disponível no plano Pro.

## Path parameters

- `id` string, required: ID (uuid) ou slug da notícia.

## Response `200`

Notícia encontrada.

- NewsDetailResponse
  - `results` NewsStoryDetail[], required: A notícia encontrada, com a matéria completa e as notícias relacionadas.
    - `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.
    - `related` NewsRelatedStory[], required: Até 6 notícias relacionadas, da mais parecida para a menos parecida.
      - `id` string, uuid, required
      - `slug` string, required
      - `title` string, required
      - `description` string, nullable, required
      - `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.
      - `eventType` 'earnings' | 'dividends' | 'guidance' | 'mna' | 'financing' | 'buyback' | 'rating' | 'analyst' | 'management' | 'legal_regulatory' | 'operations' | 'market_move' | 'macro' | 'other', required
      - `scope` 'company' | 'market', required
      - `publishedAt` string, required
      - `sentiment` 'positive' | 'negative' | 'neutral' | 'mixed', required
      - `importance` integer, required
      - `tickers` string[], required
      - `sourceCount` integer, required: Número de veículos que noticiaram o fato.
  - `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/:id/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)