البحث في البصمة السحابية

البحث في البصمة السحابية يعيد سجلاً لكل شركة لدى كل مزوّد في كل دولة. شركة على AWS في ألمانيا وعلى Cloudflare في سنغافورة تعني سجلين. يحمل كل سجل حجم التشغيل هناك، والمناطق السحابية والمدن المعنية، وتاريخ أول وآخر رصد.

cURL

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
  }'

متى تستخدمه

رصد دخول السوق. يُظهر first_seen_dates الشركات التي ظهرت بنيتها التحتية في دولة لأول مرة ضمن نطاقك الزمني.
التصفية بالحجم. يفصل host_count وserver_count بين الحضور الرمزي والنشر الفعلي.
التقسيم حسب المنصة. يجد providers وcloud_regions كل من يعمل على منصة أو منطقة بعينها.
كشف التوسّع. يعيد is_cross_border_only الحضور خارج السوق المحلية فقط.

التحديد بشركة

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-…"`

يُسمح بالبحث دون تحديد شركة، وهي الطريقة المعتادة لبناء قائمة — مثلًا {"target_locations": ["DE"], "providers": ["AWS"]}.

المرشّحات

المزوّد والمنطقة والمدينة

Key	Example
`providers`	`["AWS", "Cloudflare"]`
`cloud_regions`	`["eu-central-1", "westeurope"]`
`cities`	`["Frankfurt", "Ashburn"]`

كل مفتاح يقبل قائمة وله نظير exclude_. وcloud_regions وcities مصفوفتان في السجل، لذا تقبلان أيضًا filter_conditions للتبديل من OR (أي قيمة) إلى AND (كل القيم).

موقع البنية التحتية

Key	Example
`target_locations`	`["DE", "SG"]`
`company_locations`	`["US"]`

target_locations هو مكان تشغيل البنية التحتية، وcompany_locations هو مقر الشركة. والسجلات التي يختلف فيها الاثنان هي الأجدر بالنظر.

الحجم

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

الخمسة جميعًا تقبل [min, max]، وnull يترك أحد الحدين مفتوحًا. وكلها تصف هذا السجل وحده — مزوّد واحد في دولة واحدة.

وقت الظهور

Key	Example
`first_seen_dates`	`["2026-07-01", null]`
`last_seen_dates`	`[null, "2026-06-30"]`

كلاهما يقبل [from, to] بتواريخ ISO، ويمكن ترك أي طرف null. first_seen_dates هو مرشّح دخول السوق، وlast_seen_dates يجيب على السؤال المعاكس.

عبر الحدود فقط

اضبط is_cross_border_only: true للإبقاء على الحضور خارج السوق المحلية فقط. وتُستبعد الشركات مجهولة المقر بدل تخمينها.

الشركة ككل

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

المفاتيح ببادئة cloud_footprint_ تصف الشركة عبر كل سجلاتها لا السجل الذي أمامك. استخدمها لتصفية الشركة مع الاستمرار في رؤية جميع سجلاتها.

الصفحات والترتيب

تعمل per_page وpage وis_ascending_order كما في أي بحث. وتُرتَّب السجلات حسب last_seen_at، الأحدث رصدًا أولًا.

شكل السجل

{
  "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/…"
  }
}

هذه شركة دنماركية تعمل على Azure في هولندا: company_country_code هو DK وcountry_code هو NL، لذا is_home_market يساوي false. وevidence_url صفحة Pubrio تدعم السجل، وتكون null في السوق المحلية لأنها لا تُنتج إشارة توسّع.

وصفات

من دخل ألمانيا حديثًا
مستخدمو AWS الجادّون في آسيا
شركات منتشرة في أسواق عديدة
Pilots worth a call

cURL

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
  }'

cURL

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
  }'

cURL

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
  }'

domain_search_id في كل سجل هو شركة تعمل في خمس دول على الأقل ولها نشر فعلي في هذه الدولة.

cURL

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.

عرض على مستوى الشركة

تحليلات البصمة السحابية تأخذ domain_search_id واحدًا وتعيد الصورة الكاملة للشركة: الإجماليات، أبرز المزوّدين والدول والمناطق، سلسلة أسبوعية للبنية التحتية الجديدة، وأحدث الإضافات. استخدمها لصفحة تفاصيل الشركة، واستخدم البحث لبناء القوائم.

مراقبة التغيّرات

تظهر تغيّرات البصمة السحابية كإشارات توسّع، لذا يمكن لمراقب دفعها إلى webhook أو بريد فور حدوثها. وDNS هو نوع إشارة البصمة السحابية:

{
  "signal_types": ["expansions"],
  "signal_filters": [
    { "signal_type": "expansions", "filters": { "tos": ["DE"], "signal_types": ["DNS"], "window_days": 30 } }
  ]
}

يحمل كل إرسال evidence_url، ولا تُدرَج تفاصيل البنية التحتية الخام أبدًا. راجع إعداد webhooks.

أمور تستحق المعرفة

الشركة العاملة في دولتين تُحتسب في تفصيل كلتيهما، لذا قد يتجاوز مجموع التفاصيل الإجمالي. هذه حقيقة على مستوى كل سوق وليست ازدواج احتساب.
تكون is_cross_border بقيمة null عندما لا يُعرف مقر الشركة — أي غير معروف، لا محلي.
تُحدَّد النطاقات بصيغة [min, max] ويمكن ترك أي طرف null.
في بحث الشركات، يقصر cloud_footprint_country_activity الحدود على دولة واحدة ({"country":"DE","host_count":[100,null]})؛ أما cloud_footprint_host_count المسطّح فهو إجمالي الشركة ولا يعبّر عن ذلك.

مرجع البحث في البصمة السحابية

كل المعاملات وحقول الاستجابة.

تحليلات البصمة السحابية

إجماليات ومزوّدون ومناطق وتغيّر أسبوعي لشركة واحدة.

مرشّحات البصمة السحابية

ابحث عن الشركات ببصمتها السحابية في بحث الشركات.

إعداد webhooks

ادفع تغيّرات البصمة السحابية إلى webhook أو بريد.

Monitor

البحث

المرشحات

الأشخاص

التوسع

البحث في البصمة السحابية

متى تستخدمه

التحديد بشركة

المرشّحات

المزوّد والمنطقة والمدينة

موقع البنية التحتية

الحجم

وقت الظهور

عبر الحدود فقط

الشركة ككل

الصفحات والترتيب

شكل السجل

وصفات

عرض على مستوى الشركة

مراقبة التغيّرات

أمور تستحق المعرفة

ذات صلة

مرجع البحث في البصمة السحابية

تحليلات البصمة السحابية

مرشّحات البصمة السحابية

إعداد webhooks

​متى تستخدمه

​التحديد بشركة

​المرشّحات

​المزوّد والمنطقة والمدينة

​موقع البنية التحتية

​الحجم

​وقت الظهور

​عبر الحدود فقط

​الشركة ككل

​الصفحات والترتيب

​شكل السجل

​وصفات

​عرض على مستوى الشركة

​مراقبة التغيّرات

​أمور تستحق المعرفة

​ذات صلة

مرجع البحث في البصمة السحابية

تحليلات البصمة السحابية

مرشّحات البصمة السحابية

إعداد webhooks

متى تستخدمه

التحديد بشركة

المرشّحات

المزوّد والمنطقة والمدينة

موقع البنية التحتية

الحجم

وقت الظهور

عبر الحدود فقط

الشركة ككل

الصفحات والترتيب

شكل السجل

وصفات

عرض على مستوى الشركة

مراقبة التغيّرات

أمور تستحق المعرفة

ذات صلة