Búsqueda de noticias

Búsqueda de noticias devuelve artículos de noticias que Pubrio ha clasificado, una fila por artículo. Cada fila se vincula a todas las empresas que menciona el artículo, incluye un slug de categoría (acquires, partners_with, receives_financing, …) y, si se solicita, las señales de expansión que produjo el artículo.

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
  }'

Cuándo usarla

Inteligencia de cuentas — qué le pasó a una empresa este mes, clasificado por categoría.
Prospección basada en disparadores — todas las empresas que anunciaron financiación o una adquisición en un país e idioma en los que vendes.
Evidencia de señales — con is_expansion_signal_available: true, ve qué artículos produjeron qué señales de expansión.

Para conteos y desgloses por categoría usa News Insights. Para recibir notificaciones cuando lleguen nuevos artículos, crea un Monitor con signal_types: ["news"].

Acotar a una empresa

Clave	Valor	Notas
`domains`	`["stripe.com"]`	Coincide con artículos que mencionan la empresa, no solo artículos sobre ella
`linkedin_urls`	`["https://www.linkedin.com/company/stripe"]`	Solo páginas de empresa
`companies`	`["5378845d-…"]`	Valores de `domain_search_id`

Una búsqueda sin empresa funciona — {"categories": ["acquires"], "locations": ["SG"]} — y devuelve todo el índice de esa categoría, de más reciente a más antiguo.

Filtros

Categoría y galería

Clave	Tipo	Coincide con
`categories`	`string[]`	Slugs de categoría de News Categories. Cualquiera de los listados.
`news_galleries`	`string[]`	Slugs de galería de News Galleries.
`news_gallery_ids`	`uuid[]`	Las mismas galerías por id.
`news_languages`	`string[]`	Códigos ISO 639-1 de News Languages.

Texto

Clave	Tipo	Coincide con
`search_term`	`string`	Texto libre contra el título y el resumen, en cualquier idioma soportado.
`search_terms`	`string[]`	Varios términos, cualquiera de los cuales puede coincidir.

Fechas

Clave	Tipo	Coincide con
`published_dates`	`[from, to]`	Ventana de fecha de publicación, inclusiva. Los límites de día siguen la zona horaria de tu workspace.
`published_at`	fecha o timestamp ISO	Publicado en o después de este instante, comparado en UTC.

Ubicación

Clave	Tipo	Coincide con
`locations`	`string[]`	Países sobre los que trata el artículo (`country_codes` en la fila).
`company_locations`	`string[]`	País de la sede de una empresa mencionada.

Señales de expansión

Clave	Tipo	Coincide con
`is_expansion_signal_available`	`boolean`	Añade `expansion_signals` a cada fila y habilita los dos filtros siguientes. Déjalo desactivado para la búsqueda más rápida.
`expansion_signal_types`	`string[]`	`HIRE`, `PARTNER`, `PRODUCT`, `SCALE`, … Requiere el flag anterior.
`expansion_signal_polarities`	`string[]`	`expansion`, `contraction_leading`, `contraction_confirming`, `contraction_lagging`.

Paginación y orden

Clave	Valor por defecto	Notas
`per_page` / `page`	25 / 1	Limitado por el plan; consulta `total_display_pages`.
`is_ascending_order`	`false`	Las filas se ordenan por `published_at`, de más reciente a más antiguo, con los artículos sin fecha al final. `true` invierte a más antiguo primero.

Cómo es una fila

{
  "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 y domains son arreglos paralelos y listan todas las empresas mencionadas, así que una búsqueda acotada a stripe.com puede devolver un artículo cuyo tema principal sea PayPal. Filtra del lado del cliente sobre domains si necesitas artículos donde tu empresa sea el tema.
country_codes es sobre lo que trata el artículo; company_country_codes es dónde tienen sede las empresas mencionadas. locations filtra el primero.
news_category_name está localizado según el language de la solicitud; category es el slug estable.
Con is_expansion_signal_available: true cada fila gana expansion_signals: [{ signal_type_slug, signal_strength_slug, polarity, country_code, domain_search_id, event_date }].

`metadata.ignored_fields`

Cualquier clave del body que el endpoint no reconozca se descarta y se lista aquí. "categorys" devuelve todo el índice con ignored_fields: ["categorys"], no un error.

Recetas

Noticias de financiación en japonés
Evidencia de expansión para una cuenta
Resumen diario

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
  }'

Ahora cada fila explica una señal que de otro modo solo verías como una etapa en 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 se compara en UTC, así que un timestamp móvil de 24 horas es más seguro que una fecha de calendario.

Relacionado

Referencia de News Search

Todos los parámetros y campos de respuesta.

News Insights

Menciones, temas y fuentes de una empresa en una ventana de tiempo.

News Categories

Los slugs de categoría por los que puedes filtrar.

Señales de expansión

Qué significan un tipo de señal y una polaridad.

Monitor

Búsqueda

Filtros

Personas

Expansión

Cuándo usarla

Acotar a una empresa

Filtros

Categoría y galería

Texto

Fechas

Ubicación

Señales de expansión

Paginación y orden

Cómo es una fila

`metadata.ignored_fields`

Recetas

Relacionado

Referencia de News Search

News Insights

News Categories

Señales de expansión

​Cuándo usarla

​Acotar a una empresa

​Filtros

​Categoría y galería

​Texto

​Fechas

​Ubicación

​Señales de expansión

​Paginación y orden

​Cómo es una fila

​metadata.ignored_fields

​Recetas

​Relacionado

Referencia de News Search

News Insights

News Categories

Señales de expansión

Cuándo usarla

Acotar a una empresa

Filtros

Categoría y galería

Texto

Fechas

Ubicación

Señales de expansión

Paginación y orden

Cómo es una fila

`metadata.ignored_fields`

Recetas

Relacionado