Skip to main content
POST
Nach Unternehmen 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
company_name
string

Filtert Suchergebnisse, um einen bestimmten Unternehmensnamen einzuschließen.

Stimmt der für diesen Parameter eingegebene Wert nicht mit dem Namen eines Unternehmens überein, erscheint das Unternehmen nicht in den Suchergebnissen, selbst wenn es andere Parameter erfüllt. Teilweise Übereinstimmungen werden akzeptiert.

Beispiel:

"pubrio"

companies
string<uuid>[]

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

company_groups
integer[]

Beschränkt auf Mitglieder dieser Unternehmensgruppen (IDs), etwa source_group_id oder excluded_group_id eines Monitors; seitenweise wie jede Suche.

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:
company_filters
object

Wrapper-Objekt für Filter auf Unternehmensebene. Empfohlene Gruppierung, die visuell trennt, welche Schlüssel die Person (oberste Ebene) filtern und welche das Unternehmen filtern. Akzeptiert dieselben Schlüssel wie die Unternehmensfilter auf oberster Ebene (z. B. technologies, verticals, vertical_categories, vertical_sub_categories, categories, keywords, founded_dates, employees, revenues, company_locations, company_exclude_locations, company_places, company_exclude_places, companies, domains, company_linkedin_urls, is_enable_similarity_search, similarity_score, sowie filter_conditions). Die Engine flacht dieses Objekt vor der Verarbeitung auf die oberste Ebene ab – bei Konflikten gewinnen die Schlüssel der obersten Ebene. Dieselbe Struktur wird bei Monitor company_filters verwendet. Beispiele finden Sie im Entwicklerleitfaden „Filters Overview“.

Beispiel:
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:
exclude_locations
string[]

ISO 3166-1 Alpha-2 (cca2) wird verwendet, um Standorte auszuschließen, die nicht zurückgegeben werden sollen. Weitere Informationen finden Sie über die Endpunkte location im Filters-Tab.

Beispiel:
places
string[]

Ortsnamen (Stadt, Region), mit denen Ergebnisse gefiltert werden. Akzeptiert lokalisierte oder englische Ortsnamen.

Beispiel:
exclude_places
string[]

Ortsnamen (Stadt, Region), die von den Ergebnissen ausgeschlossen werden. Akzeptiert lokalisierte oder englische Ortsnamen.

Beispiel:
job_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:
job_exclude_locations
string[]

Geografische Standorte, die von den Stellenanzeigen-Ergebnissen ausgeschlossen werden.

Beispiel:
job_posted_dates
string[]

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

Beispiel:
job_titles
string[]

Berufsbezeichnungen der Personen, die Sie finden möchten.

Die Ergebnisse umfassen auch Berufsbezeichnungen mit ähnlicher Terminologie, selbst wenn diese nicht exakt übereinstimmen. Eine Suche nach software engineer kann beispielsweise Ergebnisse für Personen mit der Bezeichnung senior software engineer liefern.

Beispiel:
verticals
integer[]

Eine Liste von vertical_id, mit der nach Unternehmen in einer bestimmten Branche oder einem bestimmten Vertical gesucht wird. Die ID finden Sie über den Endpunkt vertical im Filters-Tab.

Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["AI"].

vertical_categories
integer[]

Eine Liste von vertical_category_id, mit der nach Unternehmen in einer bestimmten Vertical-Kategorie gesucht wird. Die ID finden Sie über den Endpunkt vertical category im Filters-Tab.

Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["Information Technology"].

vertical_sub_categories
integer[]

Eine Liste von vertical_sub_category_id, mit der nach Unternehmen in einer bestimmten Vertical-Unterkategorie gesucht wird. Die ID finden Sie über den Endpunkt vertical sub category im Filters-Tab.

Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["Software"].

categories
integer[]

Eine Liste von category_id, mit der nach bestimmten Technologiekategorien gesucht wird, die von Unternehmen eingesetzt werden. Die ID finden Sie über den Endpunkt category im Filters-Tab.

Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["CDN"].

technologies
integer[]

Eine Liste von tag_id, mit der nach bestimmten von Unternehmen eingesetzten Technologien gesucht wird. Die ID finden Sie über den Endpunkt technology im Filters-Tab.

Dieser Filter unterstützt is_enable_similarity_search; nach Aktivierung können Sie beliebigen Freitext eingeben, z. B. ["Shopify"].

Ein Produktname, den die Technologieliste kennt, trifft dieses Produkt und seine eigenen Produkte ("Salesforce" trifft auch Salesforce Desk und Salesforce Service Cloud), nie ähnlich klingende; anderer Text wird per Ähnlichkeit zugeordnet.

exclude_technologies
string[]

Technologien, die das Unternehmen nicht nutzen darf, als tag_id oder mit is_enable_similarity_search als Namen wie ["Shopify"]. Ein Unternehmen ohne bekannte Technologien bleibt erhalten.

Beispiel:
employees
string[][]

Der Zahlenbereich der für das Unternehmen tätigen Mitarbeiter. Damit können Sie Unternehmen anhand der Mitarbeiterzahl finden. Sie können mehrere Bereiche hinzufügen, um Ihre Suchergebnisse zu erweitern.

Weitere Informationen finden Sie über die Endpunkte company size im Filters-Tab.

Beispiel:
revenues
integer[]

Minimal- und Maximalbereich des Unternehmensumsatzes.

Beispiel:
founded_dates
integer[]

Zeitraum der Unternehmensgründung in Jahren. Der maximale Gründungswert ist das aktuelle Jahr.

Beispiel:
keywords
string[]

Eine Liste von Stichwörtern, mit der Unternehmen nach Relevanz, Spezialisierung oder Beschreibung gefiltert werden.

Beispiel:
social_media
enum<string>[]

Unternehmen mit einem Profil auf einer der folgenden Plattformen: linkedin, facebook, instagram, tiktok, twitter, x, github, wantedly, rocketpunch. Mit filter_conditions zu AND aufwerten.

Verfügbare Optionen:
linkedin,
facebook,
instagram,
tiktok,
twitter,
x,
github,
wantedly,
rocketpunch
Beispiel:
news_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:
news_published_dates
string[]

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

Beispiel:
advertisement_search_terms
string[]

Stichwörter zur Suche innerhalb von Anzeigeninhalten oder -titeln.

Beispiel:
advertisement_target_locations
string[]

Geografische Zielstandorte für Anzeigen.

Beispiel:
advertisement_exclude_target_locations
string[]

Geografische Standorte, die vom Anzeigen-Targeting ausgeschlossen werden.

Beispiel:
advertisement_start_dates
string<date>[]

Startdatumsbereich für die Anzeigenfilterung.

Beispiel:
advertisement_end_dates
string<date>[]

Enddatumsbereich für die Anzeigenfilterung.

Beispiel:
advertisement_active_dates
string<date>[]

Findet Anzeigen, die irgendwann innerhalb dieses Datumsbereichs liefen (überschneidungsbasiert: schließt Anzeigen ein, die vor dem Bereich begonnen haben und noch laufen, nicht nur solche, die innerhalb des Bereichs gestartet sind).

Beispiel:
advertisement_status
enum<string>[]

currently_running: Unternehmen mit erfasster Werbung. active_last_30_min: Unternehmen, deren Werbung sich in den letzten 30 Minuten geändert hat.

Verfügbare Optionen:
currently_running,
active_last_30_min
Beispiel:
advertisement_headlines
string[]

Stichwörter zur Suche im Schlagzeilentext von Anzeigen.

Beispiel:
advertisement_platforms
enum<string>[]

Filtert danach, aus welcher Anzeigenbibliothek die Anzeige stammt. Kleinschreibung, Groß-/Kleinschreibung wird nicht unterschieden. meta wird als Alias für facebook akzeptiert.

Verfügbare Optionen:
linkedin,
facebook,
google,
tiktok,
apple
Beispiel:
advertisement_publisher_platforms
enum<string>[]

Filtert Facebook/Meta-Anzeigen nach der Plattformoberfläche, auf der sie ausgeliefert wurden. Kleinschreibung, Groß-/Kleinschreibung wird nicht unterschieden. Gilt nur für die Quelle facebook (andere Quellen sind Einzelplattform-Quellen).

Verfügbare Optionen:
facebook,
instagram,
messenger,
threads,
audience_network
Beispiel:
advertisement_exclude_publisher_platforms
enum<string>[]

Schließt Facebook/Meta-Anzeigen aus, die auf diesen Plattformoberflächen ausgeliefert wurden.

Verfügbare Optionen:
facebook,
instagram,
messenger,
threads,
audience_network
Beispiel:
advertisement_formats
enum<string>[]

Findet Unternehmen mit mindestens einer Anzeige in einem dieser Creative-Formate.

Verfügbare Optionen:
image,
video,
text,
carousel,
dynamic_product,
document,
message,
event,
article,
spotlight,
follow,
job,
engagement
Beispiel:
advertisement_active_ads
(integer | null)[]

Minimale und maximale Anzahl der derzeit aktiven Anzeigen des Unternehmens, über alle Länder hinweg. Verwenden Sie null für eine offene Grenze, z. B. [1, null] für „mindestens eine aktive Anzeige“.

Required array length: 2 elements
Beispiel:
advertisement_running_ads
(integer | null)[]

Minimale und maximale Anzahl der noch laufenden Anzeigen des Unternehmens (kein Enddatum oder ein Enddatum in der Zukunft). Derzeit nur für LinkedIn-Anzeigen befüllt.

Required array length: 2 elements
Beispiel:
advertisement_total_ads
(integer | null)[]

Minimale und maximale Gesamtzahl der jemals erfassten Anzeigen des Unternehmens, über alle Länder hinweg.

Required array length: 2 elements
Beispiel:
advertisement_platform_count
(integer | null)[]

Minimale und maximale Anzahl unterschiedlicher Anzeigenplattformen (linkedin, facebook, google, tiktok, apple), auf denen das Unternehmen aktiv wirbt.

Required array length: 2 elements
Beispiel:
advertisement_format_count
(integer | null)[]

Minimale und maximale Anzahl unterschiedlicher Anzeigen-Creative-Formate, die das Unternehmen aktiv schaltet.

Required array length: 2 elements
Beispiel:
advertisement_impressions_estimate
(integer | null)[]

Minimal und maximal geschätzte Anzeigenimpressionen, summiert über alle Länder. Es werden nur Anzeigen mit gemeldetem Impressionsbereich gezählt.

Required array length: 2 elements
Beispiel:
advertisement_country_activity
object

Werbeaktivität für ein bestimmtes Land. country ist erforderlich, und mindestens ein weiteres Feld muss gesetzt sein (ein Land allein liefert keine Treffer). Für eine länderübergreifende Gesamtsumme verwenden Sie stattdessen die übergeordneten Filter advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate.

Beispiel:
sort_by
enum<string>

Ergebnisreihenfolge. Lassen Sie das Feld weg für die standardmäßige Relevanzsortierung. advertisement_country_rank sortiert nach dem Anzeigenrang des Unternehmens innerhalb des in advertisement_country_activity genannten Landes (Rang 1 = größter Werbetreibender in diesem Markt) und wird ignoriert, wenn dieser Filter fehlt. Kombinieren Sie es mit is_ascending_order: false, um die kleinsten Werbetreibenden zuerst aufzulisten. Noch nicht verfügbar: name (in beiden Richtungen) und relevance mit is_ascending_order: false – diese Anfragen laufen in eine Zeitüberschreitung. Verwenden Sie stattdessen die Standard-Relevanzreihenfolge, number_of_employees oder founded_year.

Verfügbare Optionen:
relevance,
name,
number_of_employees,
founded_year,
advertisement_country_rank
Beispiel:

"advertisement_country_rank"

is_ascending_order
boolean

Sortierrichtung für sort_by. Standardmäßig aufsteigend, was bei advertisement_country_rank die größten Werbetreibenden zuerst bedeutet.

Beispiel:

true

filter_conditions
object[]

Erweiterte Filteroptionen für Unternehmenssuchen. Geben Sie Bedingungen an, die Schlüssel und logische Operatoren kombinieren, um Suchergebnisse zu verfeinern.

Bei Aktivierung können die oben aufgeführten Filter, die Ähnlichkeitssuchen unterstützen, anstelle bestimmter IDs mit Freitext befüllt werden.

similarity_score
number<float>

Wird in Verbindung mit is_enable_similarity_search verwendet. Diese Zahl dient dazu, zu analysieren, ob ein bestimmter Slug (z. B. Branche, Technologie) der Nutzereingabe ähnelt; je höher die Zahl, desto strenger ist die Prüfung.

Beispiel:

0.7

query
string

Suche in natürlicher Sprache. Wenn angegeben, übersetzt Pubrio sie in die folgenden Unternehmensfilter: Branche (und auszuschließende Branchen), Spezialgebiet, Technologie (und auszuschließende Tools), Social-Media-Profile, Land, Region oder Stadt des Hauptsitzes, Mitarbeiterzahl, Umsatz, Gründungsjahr, ausgeschriebene Stellen und deren Ort, News-Ereignisse wie "kürzlich expandiert", Werbung (Plattform, Format, Zielland, Anzahl der Anzeigen, Impressionen, Daten, Rang in einem Land) und Cloud-Hosting (Anbieter, Serverländer und -städte, Anzahl der Hosts und Server, gesamt oder in einem Land). Mit "oder" verbundene Werte treffen zu, wenn einer passt; mit "und" verbundene Tools oder Profile ("nutzt sowohl Salesforce als auch HubSpot") müssen alle passen. Explizit mitgesendete Filter haben Vorrang vor den interpretierten. Ein Teil des Satzes, den kein Filter ausdrücken kann (zum Beispiel Eigentumsverhältnisse), wird in metadata.unmatched_criteria zurückgegeben statt verworfen; ein Satz ohne durchsuchbaren Inhalt liefert keine Ergebnisse mit metadata.nl_no_intent: true.

Beispiel:

"Food & Beverage companies in Singapore that recently expanded"

exclude_fields
string[]

Liste der Felder, die aus dem Antwort-Payload ausgeschlossen werden.

Beispiel:
is_parameter_metadata_available
boolean

Gibt an, ob Parameter-Metadaten für die Anfrage verfügbar sind.

is_profile_metadata_available
boolean

Gibt an, ob Profil-Metadaten für die Anfrage verfügbar sind.

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

cloud_footprint_providers
string[]

Unternehmen, die einen dieser Anbieter irgendwo nutzen. Das präfixlose providers grenzt die Zeilen ein, dieses die Unternehmen.

Beispiel:
cloud_footprint_exclude_providers
string[]

Zeilen ausschließen, die diesen Cloud- oder Hosting-Anbietern entsprechen. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

Beispiel:
cloud_footprint_target_locations
string[]

Unternehmen, die in einem dieser Länder irgendwo in ihrem Footprint präsent sind.

Beispiel:
cloud_footprint_exclude_target_locations
string[]

Zeilen ausschließen, die diesen Ländercodes des Infrastrukturstandorts entsprechen.

Beispiel:
cloud_footprint_cloud_regions
string[]

Nur Zeilen zurückgeben, die diesen Cloud-Regionen entsprechen. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

Beispiel:
cloud_footprint_exclude_cloud_regions
string[]

Zeilen ausschließen, die diesen Cloud-Regionen entsprechen. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

Beispiel:
cloud_footprint_cities
string[]

Nur Zeilen zurückgeben, die diesen Städten entsprechen. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

Beispiel:
cloud_footprint_exclude_cities
string[]

Zeilen ausschließen, die diesen Städten entsprechen. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

Beispiel:
cloud_footprint_first_seen_dates
(string | null)[]

Zwei ISO-8601-Daten (JJJJ-MM-TT), die eingrenzen, wann der Footprint erstmals gesehen wurde. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

Required array length: 2 elements
Beispiel:
cloud_footprint_last_seen_dates
(string | null)[]

Zwei ISO-8601-Daten (JJJJ-MM-TT), die eingrenzen, wann der Footprint zuletzt gesehen wurde. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

Required array length: 2 elements
Beispiel:
cloud_footprint_is_cross_border_only
boolean

Bei true werden nur Zeilen außerhalb des Heimatmarkts zurückgegeben. Zeilen ohne bekannten Unternehmenssitz entfallen.

Beispiel:

true

cloud_footprint_host_count
(integer | null)[]

Minimum und Maximum für Hosts. null lässt eine Grenze offen. Zählt für das gesamte Unternehmen, über alle Anbieter und Länder.

Required array length: 2 elements
Beispiel:
cloud_footprint_server_count
(integer | null)[]

Minimum und Maximum für Server (eindeutige IPs). null lässt eine Grenze offen. Zählt für das gesamte Unternehmen, über alle Anbieter und Länder.

Required array length: 2 elements
Beispiel:
cloud_footprint_shared_server_count
(integer | null)[]

Minimum und Maximum für mit anderen Unternehmen geteilten Servern. null lässt eine Grenze offen. Zählt für das gesamte Unternehmen, über alle Anbieter und Länder.

Required array length: 2 elements
Beispiel:
cloud_footprint_provider_count
(integer | null)[]

Minimum und Maximum für verschiedenen Anbietern des Unternehmens. null lässt eine Grenze offen. Zählt für das gesamte Unternehmen, über alle Anbieter und Länder.

Required array length: 2 elements
Beispiel:
cloud_footprint_country_count
(integer | null)[]

Minimum und Maximum für Ländern, in denen das Unternehmen hostet. null lässt eine Grenze offen. Zählt für das gesamte Unternehmen, über alle Anbieter und Länder.

Required array length: 2 elements
Beispiel:
cloud_footprint_cross_border_country_count
(integer | null)[]

Minimum und Maximum für Ländern außerhalb des Heimatmarkts. null lässt eine Grenze offen. Zählt für das gesamte Unternehmen, über alle Anbieter und Länder.

Required array length: 2 elements
Beispiel:
cloud_footprint_region_count
(integer | null)[]

Minimum und Maximum für Cloud-Regionen. null lässt eine Grenze offen. Zählt für das gesamte Unternehmen, über alle Anbieter und Länder.

Required array length: 2 elements
Beispiel:
cloud_footprint_city_count
(integer | null)[]

Minimum und Maximum für Städten. null lässt eine Grenze offen. Zählt für das gesamte Unternehmen, über alle Anbieter und Länder.

Required array length: 2 elements
Beispiel:
cloud_footprint_primary_provider
string[]

Unternehmen, deren größter Anbieter einer davon ist.

Beispiel:
cloud_footprint_country_activity
object

Grenzwerte auf ein Land bezogen: {"country":"DE","host_count":[100,null]} findet Unternehmen mit 100+ Hosts speziell in Deutschland. Das schlichte cloud_footprint_host_count ist die Unternehmenssumme über alle Länder; zusammen lässt sich das nicht ausdrücken. country allein wird abgelehnt.

Antwort

Erfolgreiche Antwort mit Details zur Unternehmenssuche.

metadata
object

Anfragekontext: recent_search_log_identifier, gespiegelte parameters und filters, ein optionaler profile-Credit-Block sowie ignored_fields (Body-Schlüssel, die der Endpunkt verworfen hat).

data
object | null

Die Antwortinformationen hängen vom jeweiligen Endpunkt ab.

Zuletzt geändert am 4. September 2026