Busca de notícias

O News Search retorna artigos de notícias que a Pubrio classificou, uma linha por artigo. Cada linha vincula todas as empresas mencionadas no artigo, carrega um slug de categoria (acquires, partners_with, receives_financing, …) e, sob solicitação, os sinais de expansão que o artigo produziu.

curl -X POST https://api.pubrio.com/companies/news/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["stripe.com"],
    "categories": ["partners_with", "launches"],
    "published_dates": ["2026-08-01", "2026-09-04"],
    "per_page": 25
  }'

Quando usar

Inteligência de contas — o que aconteceu com uma empresa neste mês, categorizado.
Prospecção baseada em gatilhos — toda empresa que anunciou financiamento ou uma aquisição em um país e idioma para os quais você vende.
Evidência de sinal — com is_expansion_signal_available: true, veja quais artigos produziram quais sinais de expansão.

Para contagens e detalhamentos por categoria, use News Insights. Para ser notificado assim que artigos chegarem, crie um Monitor com signal_types: ["news"].

Restringir a uma empresa

Chave	Valor	Observações
`domains`	`["stripe.com"]`	Corresponde a artigos que mencionam a empresa, não apenas artigos sobre ela
`linkedin_urls`	`["https://www.linkedin.com/company/stripe"]`	Apenas páginas de empresa
`companies`	`["5378845d-…"]`	Valores de `domain_search_id`

Uma busca sem empresa funciona — {"categories": ["acquires"], "locations": ["SG"]} — e retorna todo o índice daquela categoria, do mais recente para o mais antigo.

Filtros

Categoria e galeria

Chave	Tipo	Corresponde a
`categories`	`string[]`	Slugs de categoria de News Categories. Qualquer slug listado.
`news_galleries`	`string[]`	Slugs de galeria de News Galleries.
`news_gallery_ids`	`uuid[]`	As mesmas galerias por id.
`news_languages`	`string[]`	Códigos ISO 639-1 de News Languages.

Texto

Chave	Tipo	Corresponde a
`search_term`	`string`	Texto livre contra título e resumo, em qualquer idioma suportado.
`search_terms`	`string[]`	Vários termos, qualquer um dos quais pode corresponder.

Datas

Chave	Tipo	Corresponde a
`published_dates`	`[from, to]`	Janela de data de publicação, inclusiva. Os limites de dia seguem o fuso horário do seu workspace.
`published_at`	data ou timestamp ISO	Publicado neste instante ou depois, comparado em UTC.

Localização

Chave	Tipo	Corresponde a
`locations`	`string[]`	Países sobre os quais o artigo trata (`country_codes` na linha).
`company_locations`	`string[]`	País da sede de uma empresa mencionada.

Sinais de expansão

Chave	Tipo	Corresponde a
`is_expansion_signal_available`	`boolean`	Anexa `expansion_signals` a cada linha e ativa os dois filtros abaixo. Deixe desativado para a busca mais rápida.
`expansion_signal_types`	`string[]`	`HIRE`, `PARTNER`, `PRODUCT`, `SCALE`, … Requer a flag acima.
`expansion_signal_polarities`	`string[]`	`expansion`, `contraction_leading`, `contraction_confirming`, `contraction_lagging`.

Paginação e ordem

Chave	Padrão	Observações
`per_page` / `page`	25 / 1	Limitado pelo plano; veja `total_display_pages`.
`is_ascending_order`	`false`	As linhas são ordenadas por `published_at`, das mais recentes para as mais antigas, com artigos sem data por último. `true` inverte para as mais antigas primeiro.

Como é uma linha

{
  "news_id": "76886b56-3418-476a-a531-fff18deb29db",
  "news_search_id": "4d950aea-e2bb-4367-869b-c34e834a82ec",
  "title": "PayPal Rejects Takeover, Rated Buy",
  "summary": "…",
  "url": "https://seekingalpha.com/article/4942660-…",
  "source": "seekingalpha.com",
  "image_url": "https://static.seekingalpha.com/…",
  "language": "en",
  "published_at": "2026-09-03T08:54:21.000000Z",
  "last_modified": "2026-09-03T09:20:55.189Z",
  "category": "receives_financing",
  "news_category_name": "Funding Announcements",
  "news_galleries": [{ "news_gallery_id": "342f2eb1-…", "slug": "general-business", "name": "General Business" }],
  "country_codes": null,
  "company_country_codes": ["US"],
  "locations": null,
  "domains": ["paypal.com", "stripe.com"],
  "companies": [
    { "domain_search_id": "5378845d-…", "company_name": "Stripe", "domain": "stripe.com", "country_code": "US", "…": "…" },
    { "domain_search_id": "b03b312a-…", "company_name": "PayPal", "domain": "paypal.com", "country_code": "US", "…": "…" }
  ]
}

companies e domains são arrays paralelos e listam todas as empresas mencionadas, então uma busca restrita a stripe.com pode retornar um artigo cujo assunto principal é a PayPal. Filtre no lado do cliente por domains se precisar de artigos em que sua empresa seja o assunto.
country_codes é sobre o que trata o artigo; company_country_codes é onde as empresas mencionadas estão sediadas. locations filtra o primeiro.
news_category_name é localizado de acordo com o language da requisição; category é o slug estável.
Com is_expansion_signal_available: true, cada linha ganha expansion_signals: [{ signal_type_slug, signal_strength_slug, polarity, country_code, domain_search_id, event_date }].

`metadata.ignored_fields`

Qualquer chave do corpo que o endpoint não reconhece é descartada e listada aqui. "categorys" retorna todo o índice com ignored_fields: ["categorys"], não um erro.

Receitas

Notícias de financiamento em japonês
Evidência de expansão para uma conta
Resumo diário

cURL

curl -X POST https://api.pubrio.com/companies/news/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "categories": ["receives_financing"],
    "news_languages": ["ja"],
    "published_dates": ["2026-08-01", "2026-09-04"],
    "per_page": 25
  }'

cURL

curl -X POST https://api.pubrio.com/companies/news/search \
  -H "pubrio-api-key: $PUBRIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["stripe.com"],
    "is_expansion_signal_available": true,
    "expansion_signal_types": ["HIRE", "PARTNER", "PRODUCT", "OFFICE"],
    "expansion_signal_polarities": ["expansion"],
    "per_page": 25
  }'

Agora cada linha explica um sinal que, de outra forma, você só veria como um estágio em Company expansion detail.

Python

import os, requests
from datetime import datetime, timedelta, timezone

since = (datetime.now(timezone.utc) - timedelta(days=1)).strftime("%Y-%m-%dT%H:%M:%SZ")
body = requests.post(
    "https://api.pubrio.com/companies/news/search",
    headers={"pubrio-api-key": os.environ["PUBRIO_API_KEY"]},
    json={"domains": ["stripe.com", "adyen.com"], "published_at": since, "per_page": 25},
).json()

for a in body["data"]["news"]:
    subjects = ", ".join(c["company_name"] for c in a["companies"])
    print(f'[{a["category"]}] {a["title"]} — {subjects}')

published_at é comparado em UTC, então um timestamp móvel de 24 horas é mais seguro do que uma data de calendário.

Relacionados

Referência do News Search

Todos os parâmetros e campos de resposta.

News Insights

Menções, tópicos e fontes de uma empresa em uma janela de tempo.

News Categories

Os slugs de categoria pelos quais você pode filtrar.

Sinais de expansão

O que significam um tipo de sinal e uma polaridade.

Monitoramento

Busca

Filtros

Pessoas

Expansão

Quando usar

Restringir a uma empresa

Filtros

Categoria e galeria

Texto

Datas

Localização

Sinais de expansão

Paginação e ordem

Como é uma linha

`metadata.ignored_fields`

Receitas

Relacionados

Referência do News Search

News Insights

News Categories

Sinais de expansão

​Quando usar

​Restringir a uma empresa

​Filtros

​Categoria e galeria

​Texto

​Datas

​Localização

​Sinais de expansão

​Paginação e ordem

​Como é uma linha

​metadata.ignored_fields

​Receitas

​Relacionados

Referência do News Search

News Insights

News Categories

Sinais de expansão

Quando usar

Restringir a uma empresa

Filtros

Categoria e galeria

Texto

Datas

Localização

Sinais de expansão

Paginação e ordem

Como é uma linha

`metadata.ignored_fields`

Receitas

Relacionados