Skip to main content
POST
Nach Unternehmensnachrichten suchen

Autorisierungen

pubrio-api-key
string
header
erforderlich

Ein eindeutiges API-Token, das die von Ihnen über die API durchgeführten Aktionen sowie die zugehörigen Berechtigungen und Vorgänge repräsentiert. Sie können es über den Bereich Settings erstellen.

Body

application/json
locations
string[]

ISO 3166-1 Alpha-2 (cca2) wird zum Filtern von Standorten verwendet. Weitere Informationen finden Sie über die Endpunkte location im Filters-Tab.

Beispiel:
company_locations
string[]

Der Standort des Unternehmenshauptsitzes. Weitere Informationen finden Sie über die Endpunkte location im Filters-Tab.

Beispiel:
companies
string<uuid>[]

Eine Liste eindeutiger Kennungen (domain_search_id) für Unternehmens- und Personensuchvorgänge.

news_search_id
string<uuid>

Nur diesen einen Datensatz zurückgeben. Praktisch, um eine zuvor gespeicherte Zeile ohne Paginierung erneut abzurufen.

Beispiel:

"4110b929-17cd-42aa-a159-906ead0c9b56"

domains
string[]

Liste von Unternehmensdomains für Unternehmens- und Personensuchvorgänge. Erhalten wir eine URL wie www.pubrio.com oder https://docs.pubrio.com/, wandelt das System diese zur Verarbeitung in pubrio.com um.

Beispiel:
linkedin_urls
string[]

Die vollständige URL des LinkedIn-Unternehmensprofils. Die URL beginnt mit http und enthält linkedin.com/company/

Beispiel:
search_term
string

Eine Wortfolge, nach der die Ergebnisse gefiltert werden sollen.

Beispiel:

"pubrio"

search_terms
string[]

Array von Schlüsselwort-Zeichenfolgen zum Filtern von Nachrichtenartikeln. Jeder Begriff wird mit dem Inhalt des Artikels abgeglichen. Verwenden Sie search_term für eine einzelne Zeichenfolge oder search_terms für mehrere Schlüsselwörter.

Beispiel:
categories
string[]

Liste von category slugs zur Suche nach bestimmten News-Kategorien. Den Slug finden Sie über den Endpunkt news categories im Filters-Tab.

Beispiel:

Eine Liste von news_gallery_id, mit der nach bestimmten News-Galerien gesucht wird. Die ID finden Sie über den Endpunkt news galleries im Filters-Tab.

published_dates
string[]

Datumsbereich des Publikationsdatums. Der Maximalwert ist der aktuelle Tag. Tagesgrenzen richten sich nach der Zeitzone Ihres Workspace.

Beispiel:
published_at
string<date-time>

Veröffentlicht zu oder nach diesem Zeitpunkt (UTC). Datum oder ISO-Zeitstempel. published_dates ist die geschlossene Fensterform und verwendet die Zeitzone Ihres Workspace.

Beispiel:

"2026-09-01T00:00:00Z"

per_page
integer
Standard:25

Datensätze pro Seite. Standardmäßig 25, was bei den meisten Tarifen auch die Obergrenze ist — das Limit ist der max_search_per_page-Wert Ihres Abonnements, zurückgegeben von Profile. Bei Überschreitung wird HTTP 416 mit dem Code 41676 (oder 41613 bei der Unternehmens- und Personensuche) zurückgegeben, keine begrenzte Ergebnismenge.

Erforderlicher Bereich: x <= 25
Beispiel:

25

page
integer
Standard:1

Seitenzahl, beginnend bei 1. Die Obergrenze ist der max_search_page-Wert Ihres Abonnements (max_company_search_page für die Unternehmenssuche), zurückgegeben von Profile. Bei Überschreitung wird HTTP 416 zurückgegeben.

Beispiel:

1

is_ascending_order
boolean
Standard:false

Sortierrichtung. Ergebnisse werden standardmäßig neueste zuerst zurückgegeben; setzen Sie true für älteste zuerst. Dieser Endpunkt kennt kein sort_by – der Sortierschlüssel ist fest und in der Endpunktbeschreibung angegeben.

Beispiel:

false

news_galleries
string[]

Liste von gallery slugs zum Filtern von Nachrichten nach Galerie. Einen Slug finden Sie über den news galleries-Endpunkt im Filters-Tab.

Beispiel:
news_languages
string[]

Liste von locale_code-Werten zum Filtern von Nachrichten nach Sprache. Verfügbare Codes finden Sie über den news languages-Endpunkt im Filters-Tab.

Beispiel:
is_expansion_signal_available
boolean

Bei true werden die aufgelösten Expansionssignale (expansion_signals) an jeden News-Eintrag angehängt und die Filter expansion_signal_types / expansion_signal_polarities aktiviert. Für die schnellste Suche nicht setzen – der Expansions-Join wird nur hinzugefügt, wenn dieses Flag aktiviert ist.

expansion_signal_types
enum<string>[]

Gibt nur News zurück, die ein Expansionssignal eines dieser Typen (Slugs in Großbuchstaben) erzeugt haben. Erfordert is_expansion_signal_available: true. Unbekannte Slugs werden ignoriert.

Verfügbare Optionen:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Beispiel:
expansion_signal_polarities
enum<string>[]

Gibt nur News zurück, deren Expansionssignal eine dieser Polaritäten trägt. Erfordert is_expansion_signal_available: true. Wird mit expansion_signal_types als AND kombiniert.

Verfügbare Optionen:
expansion,
contraction_leading,
contraction_confirming,
contraction_lagging
Beispiel:

Antwort

Erfolgreiche Antwort mit Details zur Unternehmens-Nachrichtensuche.

metadata
object

Anfragekontext.

data
object
Zuletzt geändert am 4. September 2026