> ## 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. # Cloud-Footprint-Suche > Sehen Sie, bei welchen Cloud- und Hosting-Anbietern ein Unternehmen läuft, in welchen Ländern und Regionen, und erkennen Sie neu erschlossene Märkte. [Cloud-Footprint-Suche](/de/api-reference/endpoint/companies/cloud_footprints_search) liefert eine Zeile je Unternehmen, Anbieter und Land. Ein Unternehmen auf AWS in Deutschland und auf Cloudflare in Singapur ergibt zwei Zeilen. Jede Zeile zeigt den Umfang dort, die berührten Cloud-Regionen und Städte sowie den Zeitpunkt der ersten und letzten Beobachtung. ```bash cURL theme={null} curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \ -H "pubrio-api-key: $PUBRIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "target_locations": ["DE"], "providers": ["AWS"], "first_seen_dates": ["2026-07-01", null], "host_count": [100, null], "per_page": 25 }' ``` ## Wann Sie es einsetzen * **Markteintritt erkennen.** `first_seen_dates` zeigt Unternehmen, deren Infrastruktur im gewählten Zeitfenster erstmals in einem Land auftauchte. * **Nach Größe qualifizieren.** `host_count` und `server_count` trennen eine symbolische Präsenz von echtem Betrieb. * **Nach Stack segmentieren.** `providers` und `cloud_regions` finden alle auf einer bestimmten Plattform oder in einer Region. * **Expansion erkennen.** `is_cross_border_only` liefert nur Präsenz außerhalb des Heimatmarkts. ## Auf ein Unternehmen eingrenzen | Key | Value | | ------------------ | --------------------------------------------- | | `domains` | `["stripe.com"]` | | `domain` | `"stripe.com"` | | `linkedin_urls` | `["https://www.linkedin.com/company/stripe"]` | | `companies` | `["db26de04-…"]` — `domain_search_id` values | | `domain_search_id` | `"db26de04-…"` | Eine Suche ohne Unternehmen ist erlaubt und der übliche Weg, eine Liste aufzubauen — etwa `{"target_locations": ["DE"], "providers": ["AWS"]}`. ## Filter ### Anbieter, Region und Stadt | Key | Example | | --------------- | -------------------------------- | | `providers` | `["AWS", "Cloudflare"]` | | `cloud_regions` | `["eu-central-1", "westeurope"]` | | `cities` | `["Frankfurt", "Ashburn"]` | Jeder Schlüssel nimmt eine Liste und hat ein `exclude_`-Gegenstück. `cloud_regions` und `cities` sind Arrays auf der Zeile und akzeptieren daher auch `filter_conditions`, um von OR (irgendein Wert) auf AND (alle) zu wechseln. ### Wo die Infrastruktur steht | Key | Example | | ------------------- | -------------- | | `target_locations` | `["DE", "SG"]` | | `company_locations` | `["US"]` | `target_locations` ist der Betriebsort der Infrastruktur, `company_locations` der Unternehmenssitz. Genau die Zeilen, in denen sich beide unterscheiden, sind die interessanten. ### Umfang | Key | Meaning | | --------------------- | ----------------------------------- | | `host_count` | Hosts on this row | | `server_count` | Distinct IP addresses | | `shared_server_count` | Servers shared with other companies | | `region_count` | Cloud regions | | `city_count` | Cities | Alle fünf nehmen `[min, max]`, `null` lässt eine Grenze offen. Sie beschreiben ausschließlich diese Zeile — ein Anbieter in einem Land. ### Wann es auftauchte | Key | Example | | ------------------ | ---------------------- | | `first_seen_dates` | `["2026-07-01", null]` | | `last_seen_dates` | `[null, "2026-06-30"]` | Beide nehmen `[from, to]` als ISO-Daten, `null` öffnet jede Seite. `first_seen_dates` ist der Markteintrittsfilter, `last_seen_dates` beantwortet die Gegenfrage. ### Nur grenzüberschreitend Mit `is_cross_border_only: true` bleibt nur Präsenz außerhalb des Heimatmarkts. Unternehmen ohne bekannten Sitz werden ausgeschlossen, nicht geraten. ### Das ganze Unternehmen | Key | Meaning | | -------------------------------------------- | --------------------------------- | | `cloud_footprint_host_count` | Hosts everywhere | | `cloud_footprint_provider_count` | Distinct providers used | | `cloud_footprint_country_count` | Countries hosted in | | `cloud_footprint_cross_border_country_count` | Countries outside the home market | | `cloud_footprint_providers` | Uses any of these providers | | `cloud_footprint_primary_provider` | Largest provider is one of these | Schlüssel mit dem Präfix `cloud_footprint_` beschreiben das Unternehmen über alle seine Zeilen hinweg, nicht die Zeile vor Ihnen. Damit qualifizieren Sie das Unternehmen und sehen trotzdem all seine Zeilen. ### Paging und Reihenfolge `per_page`, `page` und `is_ascending_order` verhalten sich wie bei jeder Suche. Zeilen sind nach `last_seen_at` sortiert, zuletzt Beobachtetes zuerst. ## So sieht eine Zeile aus ```json theme={null} { "cloud_footprint_id": "b8fcf5c3-a309-4052-ae8f-fe5706051617", "domain_search_id": "db26de04-4131-493a-904b-2c7fda2873ee", "provider": "Azure", "country_code": "NL", "company_country_code": "DK", "is_home_market": false, "host_count": 437, "server_count": 8, "shared_server_count": 0, "region_count": 1, "city_count": 0, "cloud_regions": ["westeurope"], "cities": null, "first_seen_at": "2026-07-27T06:59:38.260Z", "last_seen_at": "2026-09-04T12:43:28.724Z", "evidence_url": "https://www.pubrio.com/evidence/e458a89952ed1e39e977794327939397", "companies": { "domain_search_id": "db26de04-4131-493a-904b-2c7fda2873ee", "company_name": "Wonderful Sound for All - WSA", "domain": "wsa.com", "country_code": "DK", "logo_url": "https://buckets.pubrio.com/company-logo/…" } } ``` Ein dänisches Unternehmen betreibt Azure in den Niederlanden: `company_country_code` ist `DK`, `country_code` ist `NL`, daher ist `is_home_market` `false`. `evidence_url` ist eine Pubrio-Seite, die die Zeile belegt; im Heimatmarkt ist sie `null`, da dort kein Expansionssignal entsteht. ## Rezepte ```bash cURL theme={null} curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \ -H "pubrio-api-key: $PUBRIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "target_locations": ["DE"], "first_seen_dates": ["2026-08-01", null], "is_cross_border_only": true, "host_count": [50, null], "per_page": 25 }' ``` ```bash cURL theme={null} curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \ -H "pubrio-api-key: $PUBRIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "providers": ["AWS"], "target_locations": ["SG", "JP", "IN"], "server_count": [10, null], "per_page": 25 }' ``` ```bash cURL theme={null} curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \ -H "pubrio-api-key: $PUBRIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "cloud_footprint_country_count": [5, null], "target_locations": ["DE"], "host_count": [100, null], "per_page": 25 }' ``` Die `domain_search_id` jeder Zeile ist ein Unternehmen, das in mindestens fünf Ländern betreibt und in diesem echten Umfang hat. ```bash cURL theme={null} curl -X POST https://api.pubrio.com/companies/cloud_footprints/search \ -H "pubrio-api-key: $PUBRIO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "is_cross_border_only": true, "first_seen_dates": ["2026-08-01", null], "host_count": [1, 25], "per_page": 25 }' ``` A small, brand-new footprint in a market the company is not headquartered in — the shape of a proof of concept before it becomes a deployment. ## Sicht je Unternehmen [Cloud-Footprint-Auswertung](/de/api-reference/endpoint/companies/cloud_footprints_insights) nimmt eine `domain_search_id` und liefert das Gesamtbild: Summen, führende Anbieter, Länder und Regionen, wöchentliche Reihe neuer Infrastruktur und die jüngsten Zugänge. Für die Unternehmensdetailseite; für Listen nutzen Sie die Suche. ## Änderungen beobachten Änderungen am Cloud-Footprint erscheinen als Expansionssignale, sodass ein Monitor sie direkt an einen Webhook oder per E-Mail senden kann. `DNS` ist der Cloud-Footprint-Signaltyp: ```json theme={null} { "signal_types": ["expansions"], "signal_filters": [ { "signal_type": "expansions", "filters": { "tos": ["DE"], "signal_types": ["DNS"], "window_days": 30 } } ] } ``` Jede Zustellung enthält `evidence_url`. Rohe Infrastrukturdetails sind nie Teil der Nutzlast. Siehe [Webhooks einrichten](/de/developer-guides/setting-up-webhooks). ## Wissenswertes * Ein Unternehmen, das in zwei Ländern betreibt, zählt in beiden Länderaufschlüsselungen. Die Summe der Aufschlüsselungen kann daher über den Gesamtwerten liegen – Wahrheit je Markt, keine Doppelzählung. * `is_cross_border` ist `null`, wenn kein Unternehmenssitz bekannt ist – also unbekannt, nicht inländisch. * Bereiche werden als `[min, max]` angegeben; jede Grenze darf `null` sein. * In der Unternehmenssuche begrenzt `cloud_footprint_country_activity` die Grenzwerte auf ein Land (`{"country":"DE","host_count":[100,null]}`); das flache `cloud_footprint_host_count` ist die Unternehmenssumme und kann das nicht ausdrücken. ## Verwandt Alle Parameter und Antwortfelder. Summen, Anbieter, Regionen und wöchentliche Veränderung eines Unternehmens. Unternehmen über ihren Cloud-Footprint in der Unternehmenssuche finden. Cloud-Footprint-Änderungen an einen Webhook oder per E-Mail senden.