> ## 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.
# Поиск новостей
> Находите новости о компаниях по категории, стране, языку и дате — каждая статья связана с компаниями, которые она упоминает, и, опционально, с сигналами экспансии, которые она произвела.
[News Search](/ru/api-reference/endpoint/companies/news_search) возвращает статьи, классифицированные Pubrio, по одной строке на статью. Каждая строка связана с **каждой** компанией, упомянутой в статье, несёт slug категории (`acquires`, `partners_with`, `receives_financing`, …) и, по запросу, сигналы экспансии, которые статья произвела.
```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
}'
```
## Когда это использовать
* **Аналитика по аккаунту** — что произошло с компанией в этом месяце, по категориям.
* **Поиск потенциальных клиентов на основе триггеров** — каждая компания, объявившая о финансировании или поглощении в стране и на языке, где вы продаёте.
* **Доказательства сигнала** — с `is_expansion_signal_available: true` смотрите, какие статьи произвели какие [сигналы экспансии](/ru/knowledge-base/concepts/expansion-signals).
Для подсчётов и разбивки по категориям используйте [News Insights](/ru/api-reference/endpoint/companies/news_insights). Чтобы получать уведомления по мере поступления статей, создайте Monitor с `signal_types: ["news"]`.
## Область охвата по компании
| Ключ | Значение | Примечания |
| --------------- | --------------------------------------------- | -------------------------------------------------------------------------------- |
| `domains` | `["stripe.com"]` | Совпадает со статьями, которые упоминают компанию, а не только со статьями о ней |
| `linkedin_urls` | `["https://www.linkedin.com/company/stripe"]` | Только страницы компаний |
| `companies` | `["5378845d-…"]` | Значения `domain_search_id` |
Поиск без указания компании работает — `{"categories": ["acquires"], "locations": ["SG"]}` — и возвращает весь индекс по этой категории, сначала новые.
## Фильтры
### Категория и галерея
| Ключ | Тип | Совпадает |
| ------------------ | ---------- | ------------------------------------------------------------------------------------------------------------- |
| `categories` | `string[]` | Slug категорий из [News Categories](/ru/api-reference/endpoint/news/categories). Любой из перечисленных slug. |
| `news_galleries` | `string[]` | Slug галерей из [News Galleries](/ru/api-reference/endpoint/news/galleries). |
| `news_gallery_ids` | `uuid[]` | Те же галереи по id. |
| `news_languages` | `string[]` | Коды ISO 639-1 из [News Languages](/ru/api-reference/endpoint/news/languages). |
### Текст
| Ключ | Тип | Совпадает |
| -------------- | ---------- | --------------------------------------------------------------------- |
| `search_term` | `string` | Свободный текст по заголовку и сводке, на любом поддерживаемом языке. |
| `search_terms` | `string[]` | Несколько терминов, любой из которых может совпасть. |
### Даты
| Ключ | Тип | Совпадает |
| ----------------- | -------------------------- | --------------------------------------------------------------------------------------------- |
| `published_dates` | `[from, to]` | Окно даты публикации, включительно. Границы дня следуют часовому поясу вашей рабочей области. |
| `published_at` | дата или ISO-метка времени | Опубликовано в этот момент или позже, сравнивается по UTC. |
### Локация
| Ключ | Тип | Совпадает |
| ------------------- | ---------- | -------------------------------------------------------------------- |
| `locations` | `string[]` | Страны, о которых **идёт речь** в статье (`country_codes` в строке). |
| `company_locations` | `string[]` | Страна штаб-квартиры упомянутой компании. |
### Сигналы экспансии
| Ключ | Тип | Совпадает |
| ------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `is_expansion_signal_available` | `boolean` | Прикрепить `expansion_signals` к каждой строке и включить два фильтра ниже. Оставьте выключенным для самого быстрого поиска. |
| `expansion_signal_types` | `string[]` | `HIRE`, `PARTNER`, `PRODUCT`, `SCALE`, … Требует включённого флага выше. |
| `expansion_signal_polarities` | `string[]` | `expansion`, `contraction_leading`, `contraction_confirming`, `contraction_lagging`. |
### Пагинация и порядок
| Ключ | По умолчанию | Примечания |
| -------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------ |
| `per_page` / `page` | 25 / 1 | Ограничено тарифом; см. `total_display_pages`. |
| `is_ascending_order` | `false` | Строки упорядочены по `published_at`, сначала новые, статьи без даты — последними. `true` переключает на сначала старые. |
## Как выглядит строка
```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` и `domains` — это параллельные массивы, перечисляющие **каждую** упомянутую компанию, поэтому поиск, ограниченный `stripe.com`, может вернуть статью, чей основной предмет — PayPal. Отфильтруйте на стороне клиента по `domains`, если вам нужны статьи, где ваша компания является предметом.
* `country_codes` — это то, о чём статья; `company_country_codes` — это то, где базируются упомянутые компании. `locations` фильтрует первое.
* `news_category_name` локализовано под язык запроса `language`; `category` — это стабильный slug.
* При `is_expansion_signal_available: true` каждая строка получает `expansion_signals: [{ signal_type_slug, signal_strength_slug, polarity, country_code, domain_search_id, event_date }]`.
### `metadata.ignored_fields`
Любой ключ тела, который эндпоинт не распознаёт, отбрасывается и перечисляется здесь. `"categorys"` возвращает весь индекс с `ignored_fields: ["categorys"]`, а не ошибку.
## Рецепты
```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
}'
```
Теперь каждая строка объясняет сигнал, который иначе вы бы увидели только как стадию в [Company expansion detail](/ru/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` сравнивается по UTC, поэтому скользящая 24-часовая метка времени безопаснее, чем календарная дата.
## Связанное
Каждый параметр и поле ответа.
Упоминания, темы и источники для одной компании за период.
Slug категорий, по которым можно фильтровать.
Что означают тип и полярность сигнала.