> ## 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. # إنشاء Monitor > أنشئ Monitor للبيانات: مراقبة دائمة التشغيل تُظهر باستمرار إشارات الأعمال التي تهمك — إعلانات وظائف جديدة، أخبار، إعلانات، أو تحركات توسع سوقي — من الشركات والمرشحات التي تحددها، وتُثري كل مطابقة ببيانات الشركة وجهة التواصل، وتسلّمها إلى وجهتك (بريد إلكتروني أو webhook) وفق جدولك المختار. اضبطه حقلًا بحقل، أو صِف الـ Monitor بأكمله في جملة واحدة بلغة طبيعية باستخدام `query` ويُفسَّر إلى الضبط ضمن نفس الطلب. ## OpenAPI ````yaml ar-openapi POST /monitors/create openapi: 3.0.0 info: description: >- تقدّم واجهة Pubrio API معلومات استخباراتية عن توسع السوق — إشارات في الوقت الفعلي تُعلِم عندما تدخل شركة سوقًا جديدة — إلى جانب بيانات الشركات والأشخاص التي تستند إليها. ابحث، وتحقق، وأثرِ الحسابات وجهات التواصل، واشترك في إشارات تحرك مصنَّفة ومؤرَّخة عبر أكثر من 200 سوق. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ar/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ar/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: معلومات ملف مساحة العمل وإحصاءات الاستخدام - name: Enrichment description: إثراء سجلات الأشخاص والشركات ببيانات B2B مفصّلة - name: Lookalike description: إيجاد شركات مشابهة لشركة معينة - name: Search description: البحث عن أشخاص وشركات ووظائف وأخبار وإعلانات بمرشحات - name: Lookup description: البحث عن معلومات مفصّلة لأشخاص وشركات ووظائف وأخبار وإعلانات وتقنيات محددة - name: LinkedIn description: البحث عن بيانات أشخاص وشركات عبر روابط ملفات LinkedIn - name: Redeem description: استبدال أرصدة لفتح بيانات تواصل الأشخاص (فردي ودفعي) - name: Channels description: إدارة قوالب قنوات التواصل (إنشاء، تحديث، حذف، سرد) - name: Monitor description: إنشاء وإدارة Monitors للبيانات بواجهات webhook، وإحصاءات، ومعالجة - name: Filters description: >- استرجاع قيم المرشحات المتاحة لمعاملات البحث (التقنيات، المواقع، القطاعات، إلخ) - name: API Keys description: سرد وفحص سجلات طلبات API وتحليلات الاستخدام لمفاتيح API - name: Insights description: رؤى إشارات مجمَّعة للشركات (الوظائف، الأخبار، الإعلانات). - name: Export description: تصدير بيانات دفعي (مقيَّد بالأرصدة). - name: Expansion description: >- معلومات استخباراتية عن توسع الشركات في السوق: الإشارات، المراحل، الأسواق، والتصدير. externalDocs: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. url: https://docs.pubrio.com paths: /monitors/create: post: tags: - Monitor summary: إنشاء Monitor description: >- أنشئ Monitor للبيانات: مراقبة دائمة التشغيل تُظهر باستمرار إشارات الأعمال التي تهمك — إعلانات وظائف جديدة، أخبار، إعلانات، أو تحركات توسع سوقي — من الشركات والمرشحات التي تحددها، وتُثري كل مطابقة ببيانات الشركة وجهة التواصل، وتسلّمها إلى وجهتك (بريد إلكتروني أو webhook) وفق جدولك المختار. اضبطه حقلًا بحقل، أو صِف الـ Monitor بأكمله في جملة واحدة بلغة طبيعية باستخدام `query` ويُفسَّر إلى الضبط ضمن نفس الطلب. operationId: monitors_create parameters: [] requestBody: required: true content: application/json: schema: type: object properties: name: type: string description: اسم الـ Monitor. description: type: string description: وصف الـ Monitor. status: type: string description: >- حالة دورة الحياة المراد إنشاء الـ Monitor بها. القيمة الافتراضية `active`. استخدم `draft` لحفظ Monitor نصف مكتمل: يُطلَب فقط `name`، ويُؤجَّل التحقق حتى تفعّله، ولا يعمل المسودة أبدًا. enum: - draft - active - paused - inactive default: active detection_mode: type: string description: >- كيفية اكتشاف الإشارات. يفحص `signal_first` السوق بشكل واسع؛ ويتتبع `company_first` قائمة حسابات مسمّاة ويتطلب شركة واحدة على الأقل، أو نطاقًا، أو رابط LinkedIn. **غير قابل للتغيير بعد الإنشاء** — تغييره في Monitor موجود يُعيد `40021`. أنشئ Monitor جديدًا بدلًا من ذلك. enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements - expansions description: أنواع الإشارات المراد مراقبتها. signal_filters: type: array items: type: object required: - signal_type properties: signal_type: type: string enum: - jobs - news - advertisements - expansions description: أي دفق (stream) يصفّي هذا الإدخال. filters: type: object description: >- مرشحات لهذا الدفق. تأخذ `jobs` و`news` و`advertisements` معاملات [Job Search](/ar/api-reference/endpoint/companies/job_search) و[News Search](/ar/api-reference/endpoint/companies/news_search) و[Advertisement Search](/ar/api-reference/endpoint/companies/advertisements_search). تأخذ `expansions` مفردات [Expansion Search](/ar/api-reference/endpoint/expansions/market_lookup): `froms` / `tos`، `window_days`، `stages`، `scopes`، `momentum`، `freshness`، `signal_types`، `signal_subtypes`، `signal_strengths`، `source_types`. احصل على الأسماء القياسية من [مرجع التوسع](/ar/api-reference/endpoint/expansions/types). description: إدخال واحد لكل دفق إشارة يراقبه الـ Monitor. example: - signal_type: jobs filters: locations: - US - signal_type: news filters: locations: - US - signal_type: advertisements filters: target_locations: - US - signal_type: expansions filters: tos: - US stages: - expanding - scaling signal_types: - HIRE - EXEC signal_strengths: - high - very_high company_filters: type: object description: >- مرشحات شركة عامة مطبَّقة كطبقة ثانية عبر كل أنواع الإشارات. تقبل نفس معاملات نقطة [Company Search](/ar/api-reference/endpoint/companies/search) — المواقع، عدد الموظفين، التقنيات، القطاعات، والمزيد. example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- قائمة معرّفات domain_search_id (UUID) للشركات المراد مراقبتها. تُستخدَم أساسًا في وضع company_first لتحديد الشركات المستهدفة. يمكنك أيضًا استخدام `domains` أو `linkedin_urls` كبدائل — يُطلَب واحد فقط من الثلاثة. domains: type: array items: type: string description: >- قائمة نطاقات الشركات المراد مراقبتها (مثل ["openai.com", "google.com"]). بديل لـ `companies` — يحل Pubrio هذه إلى الشركات المقابلة. يُطلَب واحد فقط من `companies` أو `domains` أو `linkedin_urls`. linkedin_urls: type: array items: type: string format: uri description: >- قائمة روابط شركات على LinkedIn المراد مراقبتها (مثل ["https://linkedin.com/company/pubrio"]). بديل لـ `companies` — يحل Pubrio هذه إلى الشركات المقابلة. يُطلَب واحد فقط من `companies` أو `domains` أو `linkedin_urls`. is_company_enrichment: type: boolean description: ما إذا كان سيتم إثراء بيانات الشركة في النتائج. is_people_enrichment: type: boolean description: ما إذا كان سيتم إثراء بيانات الأشخاص في النتائج. people_enrichment_configs: type: array items: type: object description: >- مصفوفة من طبقات إثراء الأشخاص. تشغّل كل طبقة بحثًا مستقلًا عن الأشخاص. تحتوي `max_people_to_return` (1-25)، و`people_contact_types` (مصفوفة — تشير إلى أنواع بيانات تواصل [Redeem](/ar/api-reference/endpoint/redeem/people): email-work، email-personal، phone)، و`filters` (نفس معاملات نقطة [People Search](/ar/api-reference/endpoint/people/search)). example: - filters: people_locations: - US max_people_to_return: 3 people_contact_types: - email-work destination_type: type: string description: نوع وجهة التسليم. enum: - webhook - email - sequences destination_config: type: object description: >- ضبط الوجهة. لـ webhook: يتطلب `webhook_url` (نص)، و`headers` (كائن) و`body` (كائن) اختياريان. للبريد الإلكتروني: يقبل `email` (نص) أو `emails` (مصفوفة نصوص). للتسلسلات: يتطلب `sequence_identifier` (نص) بالإضافة إلى واحد على الأقل من `is_people_search_enrolled` / `is_company_contact_enrolled` مضبوطًا على true. example: webhook_url: https://your-webhook.com/endpoint headers: Authorization: Bearer token body: pipeline: my-webhook frequency_minute: type: integer description: >- وتيرة التفعيل بالدقائق. الأدنى: 0، الأقصى: 10080، الافتراضي: 0. minimum: 0 maximum: 10080 default: 0 max_failure_trigger: type: integer description: >- الحد الأقصى للإخفاقات المتتالية قبل إيقاف الـ Monitor مؤقتًا. الأدنى: 1، الأقصى: 10، الافتراضي: 5. minimum: 1 maximum: 10 default: 5 max_daily_trigger: type: integer description: >- الحد الأقصى للتفعيلات يوميًا. الأدنى: 0، الأقصى: 86400، الافتراضي: 500. minimum: 0 maximum: 86400 default: 500 max_records_per_trigger: type: integer description: >- يتحكم في الحد الأقصى لعدد السجلات المُسلَّمة لكل تفعيل. القيم الأقل تقلل حجم الحمولة لكل تسليم، وهو موصى به لمجموعات النتائج الكبيرة أو التكاملات المحدودة المعدل. الأدنى: 1، الأقصى: 100، الافتراضي: 25. راجع [إعداد Webhooks](/ar/developer-guides/setting-up-webhooks) للإرشاد. minimum: 1 maximum: 100 default: 25 notification_email: type: string format: email description: عنوان البريد الإلكتروني لإشعارات إخفاق الـ Monitor. max_retry_per_trigger: type: integer description: >- الحد الأقصى لإعادة المحاولات لكل تفعيل. الأدنى: 0، الأقصى: 3، الافتراضي: 1. minimum: 0 maximum: 3 default: 1 retry_delay_second: type: integer description: >- التأخير بين إعادة المحاولات بالثواني. الأدنى: 1، الأقصى: 5، الافتراضي: 1. minimum: 1 maximum: 5 default: 1 query: type: string maxLength: 2000 description: >- وصف باللغة الطبيعية للـ Monitor (بأي لغة)، مثل "راقب الشركات المتوسعة إلى اليابان، احصل على أشخاص من المستوى القيادي ببريد العمل الخاص بهم، وأرسل تنبيهات بريد إلكتروني إلى me@company.com في الوقت الفعلي". يُفسَّر إلى الحقول أدناه (detection_mode، signal_types، signal_filters، people_enrichment_configs، destination_type/destination_config، frequency_minute) ضمن نفس الطلب. أي حقل تمرره أيضًا صراحة يتجاوز القيمة المفسَّرة. إن لم يكن النص طلب Monitor، يُعيد الاستدعاء 400. محدود بـ2000 حرف. deep: type: boolean description: >- اختياري، يُستخدَم فقط مع `query`. شغّل تمريرة التفكير التأملي للحصول على دقة تفسير أعلى (الافتراضي true؛ يضاعف تقريبًا زمن التفسير). اضبطه على false لتمريرة واحدة أسرع. anyOf: - title: Natural language required: - query - title: Structured fields required: - name - detection_mode - signal_types - destination_type - destination_config - title: Draft required: - name - status responses: '200': description: استجابة ناجحة تحتوي على تفاصيل الـ Monitor الذي أُنشئ حديثًا. content: application/json: schema: type: object properties: data: type: object properties: monitor_id: type: string format: uuid description: معرّف فريد للـ Monitor الذي أُنشئ حديثًا. name: type: string description: اسم الـ Monitor. description: type: string description: وصف الـ Monitor. detection_mode: type: string description: 'وضع الاكتشاف: ''company_first'' أو ''signal_first''.' signal_types: type: array items: type: string description: أنواع الإشارات التي يراقبها هذا الـ Monitor. signal_filters: type: array items: type: object description: >- مرشحات لكل نوع إشارة، كما هي مخزَّنة. عند الإنشاء بـ `query`، هذا ما فُسِّرت إليه جملتك — تحقق منه لتأكيد أن الـ Monitor يراقب ما قصدته. company_filters: type: object description: مرشحات ملف الشركة المطبَّقة على كل إشارة مطابَقة. companies: type: array items: type: string description: الشركات المراقَبة (company_first). is_company_enrichment: type: boolean description: ما إذا كانت المطابقات مُثراة بتفاصيل الشركة. is_people_enrichment: type: boolean description: ما إذا كانت المطابقات مُثراة بالأشخاص وجهات التواصل. people_enrichment_configs: type: array items: type: object description: ضبط إثراء الأشخاص، كما هو مخزَّن. destination_type: type: string description: نوع وجهة التسليم. destination_config: type: object description: >- تفاصيل وجهة التسليم (رسائل بريد إلكتروني، أو رابط webhook). frequency_minute: type: integer description: مدى تكرار تشغيل الـ Monitor، بالدقائق. notification_email: type: string nullable: true description: العنوان المُشعَر بشأن الـ Monitor نفسه. max_retry_per_trigger: type: integer description: إعادة المحاولات المسموحة لكل تفعيل. retry_delay_second: type: integer description: التأخير بين إعادة المحاولات، بالثواني. max_records_per_trigger: type: integer description: الحد الأقصى للسجلات المُسلَّمة لكل تفعيل. max_daily_trigger: type: integer description: الحد الأقصى للتفعيلات يوميًا. max_failure_trigger: type: integer description: الإخفاقات المتتالية قبل توقف الـ Monitor. status: type: string enum: - draft - active - paused - inactive description: حالة دورة الحياة التي أُنشئ بها الـ Monitor. masked_signature: type: string description: توقيع webhook المُخفى للعرض. created_at: type: string format: date-time description: الطابع الزمني لإنشاء الـ Monitor. signature: type: string format: uuid description: >- توقيع webhook للتحقق من الحمولات. يُعاد فقط عند الإنشاء. example: data: monitor_id: c9cd5421-b327-4243-9cd7-8b341b3da8bd name: Expansion signals → JP description: null detection_mode: signal_first signal_types: - expansions signal_filters: - signal_type: expansions filters: tos: - JP company_filters: {} companies: [] is_company_enrichment: false is_people_enrichment: true people_enrichment_configs: - max_people_to_return: 5 filters: management_levels: - c_suite people_contact_types: - email-work destination_type: email destination_config: emails: - me@company.com frequency_minute: 5 notification_email: null max_retry_per_trigger: 3 retry_delay_second: 60 max_records_per_trigger: 100 max_daily_trigger: 24 max_failure_trigger: 5 status: active masked_signature: 5••••••••••••••8b8 created_at: '2026-07-16T10:27:40.469Z' signature: 52209a0d-f1c8-4111-a685-ac86edc678b8 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: responses: general_error: description: >- طلب غير صحيح. كان الطلب مُصاغًا بشكل خاطئ أو يحتوي معاملات غير صالحة. تحقق من رمز الخطأ والرسالة للتفاصيل. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- تم تجاوز حد المعدل. نُفِّذت طلبات كثيرة جدًا خلال فترة زمنية معينة. أعِد المحاولة بعد إعادة ضبط نافذة حد المعدل. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- خطأ خادم داخلي. حدث خطأ غير متوقع في الخادم. تواصل مع الدعم إن استمر الخطأ. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات والعمليات المقابلة. يمكنك إنشاءه عبر قسم [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````