> ## 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.
# Recherche d'actualités
> Trouvez des actualités sur les entreprises par catégorie, pays, langue et date, chaque article étant relié aux entreprises qu'il mentionne — et, en option, aux signaux d'expansion qu'il a produits.
La [Recherche d'actualités](/fr/api-reference/endpoint/companies/news_search) renvoie les articles d'actualité classés par Pubrio, une ligne par article. Chaque ligne est reliée à **toutes** les entreprises que l'article mentionne, porte un slug de catégorie (`acquires`, `partners_with`, `receives_financing`, …) et, sur demande, les signaux d'expansion que l'article a produits.
```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
}'
```
## Quand l'utiliser
* **Intelligence de compte** — ce qui est arrivé à une entreprise ce mois-ci, classé par catégorie.
* **Prospection déclenchée par événement** — chaque entreprise ayant annoncé un financement ou une acquisition dans un pays et une langue où vous vendez.
* **Preuve du signal** — avec `is_expansion_signal_available: true`, voyez quels articles ont produit quels [signaux d'expansion](/fr/knowledge-base/concepts/expansion-signals).
Pour des comptages et des répartitions par catégorie, utilisez [News Insights](/fr/api-reference/endpoint/companies/news_insights). Pour être notifié à l'arrivée des articles, créez un Monitor avec `signal_types: ["news"]`.
## Cibler une entreprise
| Clé | Valeur | Remarques |
| --------------- | --------------------------------------------- | -------------------------------------------------------------------------------------------- |
| `domains` | `["stripe.com"]` | Correspond aux articles qui mentionnent l'entreprise, pas seulement à ceux qui la concernent |
| `linkedin_urls` | `["https://www.linkedin.com/company/stripe"]` | Pages d'entreprise uniquement |
| `companies` | `["5378845d-…"]` | Valeurs `domain_search_id` |
Une recherche sans entreprise fonctionne — `{"categories": ["acquires"], "locations": ["SG"]}` — et renvoie tout l'index pour cette catégorie, du plus récent au plus ancien.
## Filtres
### Catégorie et galerie
| Clé | Type | Correspond à |
| ------------------ | ---------- | --------------------------------------------------------------------------------------------------------------------- |
| `categories` | `string[]` | Slugs de catégorie issus de [News Categories](/fr/api-reference/endpoint/news/categories). N'importe quel slug listé. |
| `news_galleries` | `string[]` | Slugs de galerie issus de [News Galleries](/fr/api-reference/endpoint/news/galleries). |
| `news_gallery_ids` | `uuid[]` | Les mêmes galeries par identifiant. |
| `news_languages` | `string[]` | Codes ISO 639-1 issus de [News Languages](/fr/api-reference/endpoint/news/languages). |
### Texte
| Clé | Type | Correspond à |
| -------------- | ---------- | ------------------------------------------------------------------------------------ |
| `search_term` | `string` | Texte libre sur le titre et le résumé, dans n'importe quelle langue prise en charge. |
| `search_terms` | `string[]` | Plusieurs termes, dont n'importe lequel peut correspondre. |
### Dates
| Clé | Type | Correspond à |
| ----------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `published_dates` | `[from, to]` | Fenêtre de date de publication, incluse. Les limites de jour suivent le fuseau horaire de votre espace de travail. |
| `published_at` | date ou horodatage ISO | Publié à partir de cet instant, comparé en UTC. |
### Localisation
| Clé | Type | Correspond à |
| ------------------- | ---------- | -------------------------------------------------------------- |
| `locations` | `string[]` | Pays dont **traite** l'article (`country_codes` sur la ligne). |
| `company_locations` | `string[]` | Pays du siège d'une entreprise mentionnée. |
### Signaux d'expansion
| Clé | Type | Correspond à |
| ------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `is_expansion_signal_available` | `boolean` | Ajoute `expansion_signals` à chaque ligne et active les deux filtres ci-dessous. Laissez désactivé pour la recherche la plus rapide. |
| `expansion_signal_types` | `string[]` | `HIRE`, `PARTNER`, `PRODUCT`, `SCALE`, … Nécessite l'indicateur ci-dessus. |
| `expansion_signal_polarities` | `string[]` | `expansion`, `contraction_leading`, `contraction_confirming`, `contraction_lagging`. |
### Pagination et ordre
| Clé | Défaut | Remarques |
| -------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `per_page` / `page` | 25 / 1 | Plafonné selon le plan ; voir `total_display_pages`. |
| `is_ascending_order` | `false` | Les lignes sont ordonnées par `published_at`, du plus récent au plus ancien, les articles sans date en dernier. `true` inverse vers du plus ancien au plus récent. |
## À quoi ressemble une ligne
```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` et `domains` sont des tableaux parallèles qui listent **toutes** les entreprises mentionnées, donc une recherche ciblée sur `stripe.com` peut renvoyer un article dont le sujet principal est PayPal. Filtrez côté client sur `domains` si vous avez besoin d'articles où votre entreprise est le sujet.
* `country_codes` indique de quoi traite l'article ; `company_country_codes` indique où sont basées les entreprises mentionnées. `locations` filtre le premier.
* `news_category_name` est localisé selon la `language` de la requête ; `category` est le slug stable.
* Avec `is_expansion_signal_available: true`, chaque ligne gagne `expansion_signals: [{ signal_type_slug, signal_strength_slug, polarity, country_code, domain_search_id, event_date }]`.
### `metadata.ignored_fields`
Toute clé du corps que le point de terminaison ne reconnaît pas est abandonnée et listée ici. `"categorys"` renvoie l'index entier avec `ignored_fields: ["categorys"]`, et non une erreur.
## Recettes
```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
}'
```
Chaque ligne explique désormais un signal que vous n'auriez sinon vu que comme une étape sur [Company expansion detail](/fr/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` est comparé en UTC, donc un horodatage glissant de 24 heures est plus sûr qu'une date calendaire.
## Voir aussi
Chaque paramètre et champ de réponse.
Mentions, sujets et sources pour une entreprise sur une période donnée.
Les slugs de catégorie sur lesquels vous pouvez filtrer.
Ce que signifient un type de signal et une polarité.