> ## 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-Suche
> Finden Sie News zu Unternehmen nach Kategorie, Land, Sprache und Datum, wobei jeder Artikel mit den darin erwähnten Unternehmen verknüpft ist — und optional mit den daraus entstandenen Expansion-Signalen.
[News Search](/de/api-reference/endpoint/companies/news_search) liefert von Pubrio klassifizierte News-Artikel zurück, eine Zeile pro Artikel. Jede Zeile verknüpft mit **jedem** vom Artikel erwähnten Unternehmen, führt einen Kategorie-Slug (`acquires`, `partners_with`, `receives_financing`, …) und, auf Anfrage, die vom Artikel erzeugten Expansion-Signale.
```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
}'
```
## Wann verwenden
* **Account-Intelligence** — was einem Unternehmen diesen Monat widerfahren ist, kategorisiert.
* **Trigger-basiertes Prospecting** — jedes Unternehmen, das eine Finanzierung oder eine Übernahme in einem Land und einer Sprache angekündigt hat, in denen Sie verkaufen.
* **Signalbelege** — mit `is_expansion_signal_available: true` sehen Sie, welche Artikel welche [Expansion-Signale](/de/knowledge-base/concepts/expansion-signals) erzeugt haben.
Für Anzahlen und Kategorieaufschlüsselungen verwenden Sie [News Insights](/de/api-reference/endpoint/companies/news_insights). Um bei neuen Artikeln benachrichtigt zu werden, erstellen Sie einen Monitor mit `signal_types: ["news"]`.
## Auf ein Unternehmen eingrenzen
| Schlüssel | Wert | Hinweise |
| --------------- | --------------------------------------------- | ---------------------------------------------------------------------------------- |
| `domains` | `["stripe.com"]` | Trifft auf Artikel zu, die das Unternehmen erwähnen, nicht nur auf Artikel darüber |
| `linkedin_urls` | `["https://www.linkedin.com/company/stripe"]` | Nur Unternehmensseiten |
| `companies` | `["5378845d-…"]` | `domain_search_id`-Werte |
Eine Suche ohne Unternehmen funktioniert — `{"categories": ["acquires"], "locations": ["SG"]}` — und liefert den gesamten Index für diese Kategorie, neueste zuerst.
## Filter
### Kategorie und Galerie
| Schlüssel | Typ | Trifft zu auf |
| ------------------ | ---------- | ---------------------------------------------------------------------------------------------------------------- |
| `categories` | `string[]` | Kategorie-Slugs von [News Categories](/de/api-reference/endpoint/news/categories). Beliebiger aufgeführter Slug. |
| `news_galleries` | `string[]` | Galerie-Slugs von [News Galleries](/de/api-reference/endpoint/news/galleries). |
| `news_gallery_ids` | `uuid[]` | Dieselben Galerien per ID. |
| `news_languages` | `string[]` | ISO-639-1-Codes von [News Languages](/de/api-reference/endpoint/news/languages). |
### Text
| Schlüssel | Typ | Trifft zu auf |
| -------------- | ---------- | ------------------------------------------------------------------------- |
| `search_term` | `string` | Freitext gegen Titel und Zusammenfassung, in jeder unterstützten Sprache. |
| `search_terms` | `string[]` | Mehrere Begriffe, von denen jeder zutreffen kann. |
### Daten
| Schlüssel | Typ | Trifft zu auf |
| ----------------- | -------------------------- | ------------------------------------------------------------------------------------------------- |
| `published_dates` | `[von, bis]` | Veröffentlichungsdatumsfenster, inklusive. Tagesgrenzen richten sich nach der Workspace-Zeitzone. |
| `published_at` | Datum oder ISO-Zeitstempel | Veröffentlicht zu diesem Zeitpunkt oder danach, verglichen in UTC. |
### Standort
| Schlüssel | Typ | Trifft zu auf |
| ------------------- | ---------- | --------------------------------------------------------------------- |
| `locations` | `string[]` | Länder, um die es im Artikel **geht** (`country_codes` in der Zeile). |
| `company_locations` | `string[]` | Sitzland eines erwähnten Unternehmens. |
### Expansion-Signale
| Schlüssel | Typ | Trifft zu auf |
| ------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `is_expansion_signal_available` | `boolean` | Fügt jeder Zeile `expansion_signals` hinzu und aktiviert die beiden untenstehenden Filter. Für die schnellste Suche weglassen. |
| `expansion_signal_types` | `string[]` | `HIRE`, `PARTNER`, `PRODUCT`, `SCALE`, … Erfordert das obige Flag. |
| `expansion_signal_polarities` | `string[]` | `expansion`, `contraction_leading`, `contraction_confirming`, `contraction_lagging`. |
### Paginierung und Reihenfolge
| Schlüssel | Standard | Hinweise |
| -------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| `per_page` / `page` | 25 / 1 | Plan-gedeckelt; siehe `total_display_pages`. |
| `is_ascending_order` | `false` | Zeilen werden nach `published_at` sortiert, neueste zuerst, undatierte Artikel zuletzt. `true` kehrt zu ältesten zuerst um. |
## So sieht eine Zeile aus
```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` und `domains` sind parallele Arrays und listen **jedes** erwähnte Unternehmen auf, sodass eine auf `stripe.com` eingegrenzte Suche einen Artikel liefern kann, dessen Hauptthema PayPal ist. Filtern Sie clientseitig nach `domains`, wenn Sie Artikel benötigen, in denen Ihr Unternehmen das Thema ist.
* `country_codes` betrifft, worum es im Artikel geht; `company_country_codes` betrifft, wo die erwähnten Unternehmen ansässig sind. `locations` filtert das Erstere.
* `news_category_name` ist in die Anfragesprache `language` lokalisiert; `category` ist der stabile Slug.
* Mit `is_expansion_signal_available: true` erhält jede Zeile zusätzlich `expansion_signals: [{ signal_type_slug, signal_strength_slug, polarity, country_code, domain_search_id, event_date }]`.
### `metadata.ignored_fields`
Jeder vom Endpunkt nicht erkannte Body-Schlüssel wird verworfen und hier aufgeführt. `"categorys"` liefert den gesamten Index mit `ignored_fields: ["categorys"]`, keinen Fehler.
## Rezepte
```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
}'
```
Jede Zeile erklärt nun ein Signal, das Sie sonst nur als Phase bei [Company expansion detail](/de/api-reference/endpoint/expansions/company_lookup) sehen würden.
```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` wird in UTC verglichen, daher ist ein rollierender 24-Stunden-Zeitstempel sicherer als ein Kalenderdatum.
## Siehe auch
Jeder Parameter und jedes Antwortfeld.
Erwähnungen, Themen und Quellen für ein Unternehmen über ein Zeitfenster.
Die Kategorie-Slugs, nach denen Sie filtern können.
Was ein Signaltyp und eine Polarität bedeuten.