Listar artigos

GET

/news

Retorna uma lista de artigos, ordenados por data de análise e data de publicação (mais recentes primeiro).
Este endpoint é recomendado para montar feeds, listas por tema e alertas por entidade.

Quando usar

• Construir um feed de notícias no app/site
• Atualizar um dashboard com notícias recentes
• Buscar notícias relacionadas a um ticker, empresa, setor ou tema via query

Parâmetros de requisição

Parâmetro	Local	Descrição	Obrigatório
query	Query	Filtro por entidade/termo. Ex.: PETR4, VALE3, bancos, inflação.	Opcional
id	Query	Retorna um artigo específico por ObjectId (MongoDB).	Opcional
limit	Query	Quantidade de itens. Padrão: 20. Máx: 9999.	Opcional
offset	Query	Paginação (quantos itens pular). Padrão: 0.	Opcional

Boas práticas de paginação

• Para feeds, comece com limit=20 e use offset para “carregar mais”.
• Para alertas/rotinas, use limit baixo e filtre com query para reduzir ruído.

Resposta

Código	Descrição
200	Retorna a lista de artigos.
400	Parâmetros inválidos.
401	Não autorizado.

Formato da resposta

A resposta é uma lista de objetos com os campos abaixo:

Campo	Tipo	Descrição
id	string	ID único da notícia na base da Partnr.
title	string	Título original da notícia.
enhanced_title	string	Título otimizado gerado pela Partnr.
metadata	object	Metadados da notícia (datas, tags e imagem de capa).

Exemplo

[
  {
    "id": "686c4b114f0701b28ceddbed",
    "title": "Hypera (HYPE3): Fundador costura acordo e forma bloco controlador",
    "enhanced_title": "Hypera (HYPE3): Fundador forma bloco controlador com 53% do capital",
    "metadata": {
      "published_at": "2025-06-07T22:12:39.000Z",
      "analyzed_at": "2025-06-07T19:30:20.962-03:00",
      "categories": ["Governança e Compliance", "Conflitos Acionários"],
      "cover_image_url": "https://sa-east-1-public-cdn.partnr.ai/news/images/ofuk01r350.jpg"
    }
  }
]