Поиск новостей

News Search возвращает статьи, классифицированные Pubrio, по одной строке на статью. Каждая строка связана с каждой компанией, упомянутой в статье, несёт slug категории (acquires, partners_with, receives_financing, …) и, по запросу, сигналы экспансии, которые статья произвела.

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 смотрите, какие статьи произвели какие сигналы экспансии.

Для подсчётов и разбивки по категориям используйте 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. Любой из перечисленных slug.
`news_galleries`	`string[]`	Slug галерей из News Galleries.
`news_gallery_ids`	`uuid[]`	Те же галереи по id.
`news_languages`	`string[]`	Коды ISO 639-1 из 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` переключает на сначала старые.

Как выглядит строка

{
  "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"], а не ошибку.

Рецепты

Новости о финансировании на японском
Доказательства экспансии для одного аккаунта
Ежедневная сводка

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

Теперь каждая строка объясняет сигнал, который иначе вы бы увидели только как стадию в 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 сравнивается по UTC, поэтому скользящая 24-часовая метка времени безопаснее, чем календарная дата.

Связанное

Справочник News Search

Каждый параметр и поле ответа.

News Insights

Упоминания, темы и источники для одной компании за период.

News Categories

Slug категорий, по которым можно фильтровать.

Сигналы экспансии

Что означают тип и полярность сигнала.

Мониторинг

Поиск

Фильтры

Люди

Экспансия

Когда это использовать

Область охвата по компании

Фильтры

Категория и галерея

Текст

Даты

Локация

Сигналы экспансии

Пагинация и порядок

Как выглядит строка

`metadata.ignored_fields`

Рецепты

Связанное

Справочник News Search

News Insights

News Categories

Сигналы экспансии

​Когда это использовать

​Область охвата по компании

​Фильтры

​Категория и галерея

​Текст

​Даты

​Локация

​Сигналы экспансии

​Пагинация и порядок

​Как выглядит строка

​metadata.ignored_fields

​Рецепты

​Связанное

Справочник News Search

News Insights

News Categories

Сигналы экспансии

Когда это использовать

Область охвата по компании

Фильтры

Категория и галерея

Текст

Даты

Локация

Сигналы экспансии

Пагинация и порядок

Как выглядит строка

`metadata.ignored_fields`

Рецепты

Связанное