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

# التعدادات والثوابت

> كل قيمة ثابتة تقبلها أو تُعيدها واجهة Pubrio API — رتب الأقدمية، والوظائف الوظيفية، ومصادر الإعلانات وتنسيقاتها، ومستويات الوصول، وأنواع الإشارات، والمستويات الإدارية — في صفحة واحدة.

تقبل معظم مرشحات Pubrio **slug** من قائمة مغلقة. القوائم القصيرة مدرجة هنا بالكامل. أما القوائم الطويلة والمتغيرة (الدول، والتقنيات، والقطاعات الرأسية، وتصنيفات الأخبار) فتأتي من نقاط النهاية ضمن مجموعة **Filters**، وتوضح لك هذه الصفحة أيّها تستخدم.

<Warning>
  معظم مرشحات البحث **لا ترفض** قيمة غير معروفة. بعضها يتجاهل المرشح ويُعيد كل النتائج (`seniority_ranks`)، والبعض الآخر يطبّقه ويُعيد نتيجة فارغة (`functions`، `source_types`، `reach_tiers`). كلاهما يبدو استجابة `200` طبيعية. تحقّق دائمًا من `metadata.ignored_fields`، وفي بحث الإعلانات تحقق أيضًا من `metadata.unsupported_source_types`.
</Warning>

## الاصطلاحات

| الشكل                                                              | المعنى                                                                                                                                                                              | مثال                           |
| ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ |
| `["YYYY-MM-DD", "YYYY-MM-DD"]`                                     | نافذة تاريخ شاملة `[from, to]`. تتبع حدود اليوم توقيت مساحة عملك، باستثناء `launch_dates` و`active_dates` اللذين يستخدمان UTC. حيث يُذكر ذلك، يعني وجود عنصر واحد يومًا واحدًا فقط. | `["2026-08-01", "2026-08-31"]` |
| تاريخ أو طابع زمني ISO (قيمة قياسية: `created_at`، `published_at`) | عند هذه اللحظة أو بعدها، بالمقارنة بتوقيت UTC.                                                                                                                                      | `"2026-09-02T12:00:00Z"`       |
| `[min, max]` مع `null`                                             | نطاق رقمي؛ تترك `null` ذلك الطرف مفتوحًا.                                                                                                                                           | `[1, null]` = واحد على الأقل   |
| مصفوفات من slugs                                                   | تطابق **أي** قيمة مدرجة (OR) ما لم ترفع المفتاح إلى AND باستخدام [`filter_conditions`](/ar/developer-guides/filters/filter-conditions).                                             | `["linkedin", "facebook"]`     |
| رموز الدول                                                         | ISO 3166-1 alpha-2، بأحرف كبيرة. القائمة الكاملة من [Locations](/ar/api-reference/endpoint/locations/locations).                                                                    | `"US"`، `"SG"`                 |

***

## بحث الوظائف

يُستخدم في [بحث الوظائف](/ar/api-reference/endpoint/companies/job_search) ويظهر في كل صف وظيفة.

### رتب الأقدمية

مرشح `seniority_ranks` · حقل الاستجابة `seniority_rank`. يُستنتج من المسمى الوظيفي.

| الرتبة | المستوى                   | يشمل                                                                      |
| ------ | ------------------------- | ------------------------------------------------------------------------- |
| `5`    | executive (تنفيذي)        | نائب رئيس فما فوق، الملّاك، المؤسسون، الشركاء، C-suite                    |
| `4`    | director (مدير عام)       | أدوار المدير العام والرئيس الأدنى من نائب الرئيس                          |
| `3`    | manager (مدير)            | مدير                                                                      |
| `2`    | senior (أول)              | مساهم فردي أول                                                            |
| `1`    | junior (مبتدئ)            | مبتدئ، متدرب، ومساهمون أفراد آخرون                                        |
| `0`    | unclassified (غير مصنَّف) | يظهر في الاستجابة فقط — تعذّر تصنيف المسمى الوظيفي. ليست قيمة مرشح صالحة. |

تُتجاهل أي قيمة خارج النطاق `1`–`5` ويُسقَط المرشح، لذا فإن `[7]` يُعيد كل النتائج.

### الوظائف (Functions)

مرشح `functions` · حقل الاستجابة `functions` (مصفوفة، وتكون `null` عند عدم التصنيف). يمكن أن يظهر الـ slug نفسه في عدة مسميات؛ ويمكن أن يحمل المسمى الواحد عدة slugs. يطابق أي slug مدرج؛ ولا يطابق الـ slug غير المعروف أي شيء.

أكثر الـ slugs شيوعًا، مرتبة تنازليًا حسب عدد الإعلانات الوظيفية:

| Slug                       | Slug                    | Slug                          |
| -------------------------- | ----------------------- | ----------------------------- |
| `engineering`              | `sales`                 | `entrepreneurship`            |
| `human_resources`          | `operations`            | `marketing`                   |
| `consulting`               | `business_development`  | `information_technology`      |
| `education`                | `finance`               | `support`                     |
| `administrative`           | `arts_and_design`       | `media_and_commmunication`    |
| `legal`                    | `accounting`            | `data_science`                |
| `product_management`       | `engineering_technical` | `teacher`                     |
| `customer_service_support` | `software_development`  | `office_operations`           |
| `lawyer_attorney`          | `all_design`            | `project_management`          |
| `nursing`                  | `logistics`             | `financial_planning_analysis` |
| `content_marketing`        | `graphic_design`        | `executive`                   |
| `it_operations`            | `talent_management`     | `research_development`        |
| `financial_reporting`      | `quality_assurance`     | `construction`                |
| `medicine`                 | `customer_experience`   | `psychology`                  |

<Note>
  تُكتب `media_and_commmunication` بثلاثة أحرف `m` في البيانات. انسخها كما هي.
</Note>

الذيل الطويل (مئات الـ slugs الإضافية مثل `information_security`، `supply_chain`، `devops`) يستخدم نفس مفردات عمود `slug` في [وظائف الأقسام](/ar/api-reference/endpoint/departments/function). أسرع طريقة لاكتشاف slugs مجال متخصص هي تشغيل بحث دون مرشحات على بضع شركات ذات صلة وقراءة مصفوفة `functions` في الصفوف.

### أنواع مصادر الوظائف

حقل الاستجابة `source_type`. القيمة `linkedin` للغالبية العظمى من الإعلانات الوظيفية؛ وتُبلغ لوحات الوظائف الشريكة عن الـ slug الخاص بها (`wantedly`، `tw1111`، `rocketpunch`). يمكن أن تكون الصفوف الأقدم `null`.

***

## بحث الإعلانات

يُستخدم في [بحث الإعلانات](/ar/api-reference/endpoint/companies/advertisements_search)، و[رؤى الإعلانات](/ar/api-reference/endpoint/companies/advertisements_insights)، ومرشحات `advertisement_*` في [بحث الشركات](/ar/api-reference/endpoint/companies/search).

### أنواع المصادر

مرشحات `source_types` / `exclude_source_types` · حقل الاستجابة `source_type` · `advertisement_platforms` في بحث الشركات.

`linkedin` · `facebook` · `google` · `tiktok` · `apple`

تُقبل `meta` كاسم بديل لـ `facebook`. تشمل `facebook` كل واجهات Meta؛ ضيّق النطاق باستخدام `publisher_platforms`.

### التنسيقات

مرشح `advertisement_formats` · حقل الاستجابة `advertisement_format_normalized`. يُحفظ التصنيف الأصلي الذي ينشره المصدر في `advertisement_format`.

| Slug القياسي      | التصنيفات الأصلية التي يشملها                                     |
| ----------------- | ----------------------------------------------------------------- |
| `image`           | `image`، `IMAGE`، `Single Image Ad`                               |
| `video`           | `video`، `VIDEO`، `Video Ad`، `MULTI_VIDEOS`، `Premiere Video Ad` |
| `text`            | `text`، `TEXT`، `Text Ad`                                         |
| `carousel`        | `CAROUSEL`، `MULTI_IMAGES`، `MULTI_MEDIAS`، `DCO`، `Carousel Ad`  |
| `dynamic_product` | `DPA`                                                             |
| `document`        | `Document Ad`                                                     |
| `message`         | `Message Ad`                                                      |
| `event`           | `EVENT`، `Event Ad`                                               |
| `article`         | `LinkedIn Article Ad`                                             |
| `spotlight`       | `Spotlight Ad`                                                    |
| `follow`          | `Follow Company Ad`                                               |
| `job`             | `Job Ad`                                                          |
| `engagement`      | `PAGE_LIKE`                                                       |
| `other`           | يظهر في الاستجابة فقط — تصنيف أصلي غير مدرج في هذا الجدول         |

### منصات النشر

مرشحات `publisher_platforms` / `exclude_publisher_platforms` · حقل الاستجابة `publisher_platforms`. تقتصر على واجهات Meta فقط؛ وتكون `null` في أي مصدر آخر. غير حساسة لحالة الأحرف عند الإدخال، وتُعاد بأحرف صغيرة في الاستجابة.

`facebook` · `instagram` · `messenger` · `threads` · `audience_network`

### مستويات الوصول (Reach Tiers)

مرشح `reach_tiers` · فهرس `reach_tiers[]` في رؤى الإعلانات. يُشتق من **الحد الأدنى** لنطاق مرات الظهور الخاص بالمصدر، لذا يقع إعلان `10k-50k` ضمن `10k_50k`. الإعلانات التي لا تحتوي على تقدير لمرات الظهور لا تطابق أي مستوى أبدًا.

| Slug        | مرات الظهور |
| ----------- | ----------- |
| `lt_1k`     | أقل من 1K   |
| `1k_10k`    | 1K – 10K    |
| `10k_50k`   | 10K – 50K   |
| `50k_100k`  | 50K – 100K  |
| `100k_500k` | 100K – 500K |
| `500k_1m`   | 500K – 1M   |
| `1m_plus`   | أكثر من 1M  |

### حالة الإعلان

مرشح `advertisement_status` في بحث الشركات.

| Slug                 | المعنى                                                                                                                    |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `currently_running`  | الشركات التي لديها سجل إعلاني. بالنسبة للإعلانات التي لا تزال نشطة، رشِّح باستخدام `advertisement_running_ads: [1, null]` |
| `active_last_30_min` | تغيّرت سجلات إعلانات الشركة خلال آخر 30 دقيقة — مفيد للاستطلاع الدوري (polling)                                           |

### وسائل التواصل الاجتماعي

مرشح `social_media` في بحث الشركات. علاقة OR افتراضيًا.

`linkedin` · `facebook` · `instagram` · `tiktok` · `twitter` · `x` · `github` · `wantedly` · `rocketpunch`

### النشاط حسب الدولة

يقبل `advertisement_country_activity` كائنًا واحدًا: `{ "country": "US", "rank": [null, 500] }` أو `{ "country": "US", "percentile": [90, null] }`. الرتبة `1` هي أكبر معلن في تلك الدولة. راجع [مرشحات النشاط الإعلاني](/ar/developer-guides/filters/overview#مرشحات-النشاط-الإعلاني).

***

## بحث الأخبار

يُستخدم في [بحث الأخبار](/ar/api-reference/endpoint/companies/news_search) و[رؤى الأخبار](/ar/api-reference/endpoint/companies/news_insights).

| المرشح                                | المفردات                                                                        | مكان الحصول عليها                                                      |
| ------------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| `categories`                          | slugs التصنيف مثل `acquires`، `partners_with`، `receives_financing`، `launches` | [تصنيفات الأخبار](/ar/api-reference/endpoint/news/categories) — `slug` |
| `news_galleries` / `news_gallery_ids` | slug أو UUID للمعرض                                                             | [معارض الأخبار](/ar/api-reference/endpoint/news/galleries)             |
| `news_languages`                      | رموز ISO 639-1 (`en`، `ja`، `ko`، `zh`، وغيرها)                                 | [لغات الأخبار](/ar/api-reference/endpoint/news/languages)              |
| `locations` / `company_locations`     | رموز الدول                                                                      | [Locations](/ar/api-reference/endpoint/locations/locations)            |

### تعدادات إشارة التوسّع

تُطبَّق فقط عندما تكون `is_expansion_signal_available: true`.

| الحقل                            | القيم                                                                                                                                   |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| `expansion_signal_types`         | `AD` `AUDIENCE` `DNS` `ENTITY` `EVENT` `EVENT_PLUS` `EXEC` `HIRE` `INFRA` `IP` `NEWS` `OFFICE` `PARTNER` `PRODUCT` `REG` `SCALE` `TECH` |
| `expansion_signal_polarities`    | `expansion` `contraction_leading` `contraction_confirming` `contraction_lagging`                                                        |
| `signal_strength_slug` (استجابة) | `low` `medium` `high` `very_high`                                                                                                       |

مفردات التوسّع الكاملة — المراحل، والحداثة، والزخم — موجودة في [مرشحات التوسّع](/ar/api-reference/endpoint/expansions/types).

***

## بحث الأشخاص

### المستويات الإدارية

مرشح `management_levels`. يُتجاهل الـ slug غير المعروف عند وجود مرشحات أشخاص أخرى؛ وعندما يكون المرشح الوحيد للأشخاص، يفشل الطلب برمز `40037 Parameter(s) incorrect`.

`c_suite` · `director` · `entry` · `founder` · `head` · `intern` · `manager` · `owner` · `partner` · `senior` · `vp`

لاحظ أن slug فئة C-suite هو `c_suite`، وليس `c_level`. احصل على الأسماء بلغتك من [المستويات الإدارية](/ar/api-reference/endpoint/management-levels/management-levels).

### الأقسام والوظائف

| المرشح                 | المفردات                                                                   | مكان الحصول عليها                                                |
| ---------------------- | -------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `departments`          | slugs بصيغة `master_*`، مثل `master_engineering_technical`، `master_sales` | [الأقسام](/ar/api-reference/endpoint/departments/departments)    |
| `department_functions` | slugs الوظائف، مثل `software_development`، `account_management`            | [وظائف الأقسام](/ar/api-reference/endpoint/departments/function) |

***

## بحث الشركات

| المرشح                                                        | المفردات               | مكان الحصول عليها                                                                        |
| ------------------------------------------------------------- | ---------------------- | ---------------------------------------------------------------------------------------- |
| `verticals`، `vertical_categories`، `vertical_sub_categories` | slugs القطاعات الرأسية | [القطاعات الرأسية](/ar/api-reference/endpoint/verticals/verticals) ونقاط نهاية تصنيفاتها |
| `technologies`                                                | slugs التقنيات         | [التقنيات](/ar/api-reference/endpoint/technologies/technologies)                         |
| `employees`                                                   | slugs نطاق حجم الشركة  | [حجم الشركة](/ar/api-reference/endpoint/company-size/company-size)                       |
| `locations`، `exclude_locations`                              | رموز الدول             | [Locations](/ar/api-reference/endpoint/locations/locations)                              |

***

## ثوابت خاصة بالاستجابة فقط

| الحقل                                    | القيم                            | المعنى                                                  |
| ---------------------------------------- | -------------------------------- | ------------------------------------------------------- |
| `metadata.coverage_notes[].scope`        | `eea_uk_ch`                      | ملاحظة التغطية لمصدر مطلوب                              |
| `metadata.skipped_source_types[].reason` | `country_unknown_until_enriched` | لم يُطبَّق المصدر على `target_locations` المطلوبة       |
| `pagination.is_timeout`                  | `true` / `false`                 | انتهت مهلة استعلام العد؛ و`total_entries` تقدير جزئي    |
| `metadata.ignored_fields`                | مصفوفة مفاتيح الطلب              | المفاتيح التي أسقطتها نقطة النهاية لأنها لم تتعرف عليها |

## ذات صلة

<CardGroup cols={2}>
  <Card title="نظرة عامة على المرشحات" icon="filter" href="/ar/developer-guides/filters/overview">
    كيفية تجميع المصفوفات، وAND/OR، و`filter_conditions` عبر جميع نقاط نهاية البحث.
  </Card>

  <Card title="رموز الحالة" icon="triangle-exclamation" href="/ar/api-reference/status-codes">
    جدول رموز الأخطاء الكامل.
  </Card>
</CardGroup>