Skip to main content
POST
Cloud-Footprint von Unternehmen durchsuchen

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
providers
string[]

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

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

Ländercodes, auf die die Ergebnisse zielen müssen. Wird standardmäßig als OR mit filter_conditions kombiniert — ein Treffer genügt.

Beispiel:
exclude_target_locations
string[]

Ländercodes, auf die die Ergebnisse nicht zielen dürfen. Wird standardmäßig als OR mit filter_conditions kombiniert — ein Treffer genügt.

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

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

Beispiel:
exclude_cities
string[]

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

Beispiel:
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:
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:
is_cross_border_only
boolean

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

Beispiel:

true

host_count
(integer | null)[]

Minimum und Maximum für Hosts. null lässt eine Grenze offen. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

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

Minimum und Maximum für Server (eindeutige IPs). null lässt eine Grenze offen. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

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

Minimum und Maximum für mit anderen Unternehmen geteilten Servern. null lässt eine Grenze offen. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

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

Minimum und Maximum für Cloud-Regionen. null lässt eine Grenze offen. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

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

Minimum und Maximum für Städten. null lässt eine Grenze offen. Bezieht sich nur auf diese Footprint-Zeile — ein Anbieter in einem Land.

Required array length: 2 elements
Beispiel:
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:
company_locations
string[]

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

Beispiel:
cloud_footprint_id
string<uuid>

Kennung einer einzelnen Cloud-Footprint-Zeile.

Beispiel:

"f28215e6-f6ed-40c2-ac9b-d8e70164c0be"

cloud_footprint_ids
string<uuid>[]

Kennungen ausgewählter Zeilen für den Export.

Beispiel:
companies
string<uuid>[]

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

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

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_target_locations
string[]

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

Beispiel:
cloud_footprint_primary_provider
string[]

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

Beispiel:
domain
string

Eine Unternehmensdomain für Unternehmenssuchvorgä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:

"pubrio.com"

domain_search_id
string<uuid>

Eine eindeutige Kennung für den Unternehmenssuchvorgang.

linkedin_urls
string[]

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

Beispiel:
filter_conditions
object[]

Schaltet einen Array-Filter von OR (Standard: irgendein Wert) auf AND (alle Werte) um. Gilt für cloud_regions, exclude_cloud_regions, cities und exclude_cities.

Antwort

Seitenweise Cloud-Footprint-Zeilen.

The response is of type object.

Zuletzt geändert am 4. September 2026