> ## 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.

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

> اطّلع على مزوّدي السحابة والاستضافة الذين تعمل عليهم الشركة، وفي أي دول ومناطق، واكتشف الأسواق التي دخلتها حديثًا.

[البحث في البصمة السحابية](/ar/api-reference/endpoint/companies/cloud_footprints_search) يعيد سجلاً لكل شركة لدى كل مزوّد في كل دولة. شركة على AWS في ألمانيا وعلى Cloudflare في سنغافورة تعني سجلين. يحمل كل سجل حجم التشغيل هناك، والمناطق السحابية والمدن المعنية، وتاريخ أول وآخر رصد.

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

## متى تستخدمه

* **رصد دخول السوق.** يُظهر `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`، الأحدث رصدًا أولًا.

## شكل السجل

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

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

## وصفات

<Tabs>
  <Tab title="من دخل ألمانيا حديثًا">
    ```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
      }'
    ```
  </Tab>

  <Tab title="مستخدمو AWS الجادّون في آسيا">
    ```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
      }'
    ```
  </Tab>

  <Tab title="شركات منتشرة في أسواق عديدة">
    ```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
      }'
    ```

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

  <Tab title="Pilots worth a call">
    ```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.
  </Tab>
</Tabs>

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

[تحليلات البصمة السحابية](/ar/api-reference/endpoint/companies/cloud_footprints_insights) تأخذ `domain_search_id` واحدًا وتعيد الصورة الكاملة للشركة: الإجماليات، أبرز المزوّدين والدول والمناطق، سلسلة أسبوعية للبنية التحتية الجديدة، وأحدث الإضافات. استخدمها لصفحة تفاصيل الشركة، واستخدم البحث لبناء القوائم.

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

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

```json theme={null}
{
  "signal_types": ["expansions"],
  "signal_filters": [
    { "signal_type": "expansions", "filters": { "tos": ["DE"], "signal_types": ["DNS"], "window_days": 30 } }
  ]
}
```

يحمل كل إرسال `evidence_url`، ولا تُدرَج تفاصيل البنية التحتية الخام أبدًا. راجع [إعداد webhooks](/ar/developer-guides/setting-up-webhooks).

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

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

## ذات صلة

<CardGroup cols={2}>
  <Card title="مرجع البحث في البصمة السحابية" icon="code" href="/ar/api-reference/endpoint/companies/cloud_footprints_search">
    كل المعاملات وحقول الاستجابة.
  </Card>

  <Card title="تحليلات البصمة السحابية" icon="chart-column" href="/ar/api-reference/endpoint/companies/cloud_footprints_insights">
    إجماليات ومزوّدون ومناطق وتغيّر أسبوعي لشركة واحدة.
  </Card>

  <Card title="مرشّحات البصمة السحابية" icon="filter" href="/ar/api-reference/endpoint/companies/search">
    ابحث عن الشركات ببصمتها السحابية في بحث الشركات.
  </Card>

  <Card title="إعداد webhooks" icon="webhook" href="/ar/developer-guides/setting-up-webhooks">
    ادفع تغيّرات البصمة السحابية إلى webhook أو بريد.
  </Card>
</CardGroup>