> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Búsqueda de noticias
> Encuentra noticias sobre empresas por categoría, país, idioma y fecha, con cada artículo vinculado a las empresas que menciona — y opcionalmente a las señales de expansión que produjo.
[Búsqueda de noticias](/es/api-reference/endpoint/companies/news_search) 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.
```bash theme={null}
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](/es/knowledge-base/concepts/expansion-signals).
Para conteos y desgloses por categoría usa [News Insights](/es/api-reference/endpoint/companies/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](/es/api-reference/endpoint/news/categories). Cualquiera de los listados. |
| `news_galleries` | `string[]` | Slugs de galería de [News Galleries](/es/api-reference/endpoint/news/galleries). |
| `news_gallery_ids` | `uuid[]` | Las mismas galerías por id. |
| `news_languages` | `string[]` | Códigos ISO 639-1 de [News Languages](/es/api-reference/endpoint/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
```json theme={null}
{
"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
```bash cURL theme={null}
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
}'
```
```bash cURL theme={null}
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](/es/api-reference/endpoint/expansions/company_lookup).
```python Python theme={null}
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
Todos los parámetros y campos de respuesta.
Menciones, temas y fuentes de una empresa en una ventana de tiempo.
Los slugs de categoría por los que puedes filtrar.
Qué significan un tipo de señal y una polaridad.