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

> يقرأ الصفحة التالية من تسليم مقسّم إلى صفحات (`is_paged_delivery: true`). تُثبَّت النافذة لحظة التشغيل: تحتوي الصفحة على إشارات تلك النافذة فقط، وفق الفلاتر الحالية للـ Monitor ونطاق الشركات وقائمة الاستبعاد ونافذة إزالة تكرار الشركات، وبترتيب التسليم. كل صفحة قراءة واحدة محدودة بالمفتاح، وتُحتسب مثل البحث المقابل (رصيد بحث واحد لكل نوع إشارة تقرؤه الصفحة؛ قوائم المتابعة مجانية). للصفحة شكل حمولة الـ webhook نفسه.



## OpenAPI

````yaml ar-openapi POST /monitors/signals/search
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/signals/search:
    post:
      tags:
        - Monitor
      summary: البحث في إشارات تسليم مقسّم إلى صفحات
      description: >-
        يقرأ الصفحة التالية من تسليم مقسّم إلى صفحات (`is_paged_delivery:
        true`). تُثبَّت النافذة لحظة التشغيل: تحتوي الصفحة على إشارات تلك
        النافذة فقط، وفق الفلاتر الحالية للـ Monitor ونطاق الشركات وقائمة
        الاستبعاد ونافذة إزالة تكرار الشركات، وبترتيب التسليم. كل صفحة قراءة
        واحدة محدودة بالمفتاح، وتُحتسب مثل البحث المقابل (رصيد بحث واحد لكل نوع
        إشارة تقرؤه الصفحة؛ قوائم المتابعة مجانية). للصفحة شكل حمولة الـ webhook
        نفسه.
      operationId: monitors_signals_search
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                page_token:
                  type: string
                  description: >-
                    قيمة `metadata.window.next_page_token` من تسليم مقسّم أو من
                    الصفحة السابقة. تحمل النافذة المثبّتة، لذا يقرأ الرمز نفسه
                    دائمًا النطاق نفسه؛ وقيمة `null` في الصفحة الأخيرة تعني
                    انتهاء النافذة.
              required:
                - page_token
      responses:
        '200':
          description: >-
            الصفحة، بشكل حمولة الـ webhook مع كتلة `pagination` نفسها التي
            يعيدها كل بحث. الغلاف هو `{ metadata: { monitor_log_id, page_token
            }, data: {...} }`.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      monitor_log_id:
                        type: string
                        format: uuid
                        description: >-
                          التسليم الذي تنتمي إليه هذه الصفحة (سطره في سجلات
                          الإحصاءات).
                      page_token:
                        type: string
                        description: الرمز الذي قُرئت به هذه الصفحة.
                  data:
                    type: object
                    description: >-
                      بشكل حمولة الـ webhook نفسه: `monitor` و`metadata`
                      و`triggered_at`، ثم `signals` (وحدة السجل إشارة) أو
                      `companies` (وحدة السجل شركة).
                    properties:
                      metadata:
                        type: object
                        properties:
                          monitor_log_id:
                            type: string
                            format: uuid
                            description: التسليم الذي تنتمي إليه هذه الصفحة.
                          total_signals:
                            type: integer
                            description: الإشارات في هذه الصفحة.
                          total_companies:
                            type: integer
                            description: الشركات في هذه الصفحة.
                          window:
                            type: object
                            properties:
                              from:
                                type: string
                                format: date-time
                                description: بداية النافذة (التشغيل السابق).
                              to:
                                type: string
                                format: date-time
                                description: نهاية النافذة (هذا التشغيل).
                              next_page_token:
                                type: string
                                nullable: true
                                description: رمز الصفحة التالية؛ `null` في الصفحة الأخيرة.
                      pagination:
                        $ref: '#/components/schemas/search_pagination'
              example:
                metadata:
                  monitor_log_id: 516b72de-79d5-400b-9bae-423a43eca98b
                  page_token: c2b1…
                data:
                  monitor:
                    monitor_id: c9cd5421-b327-4243-9cd7-8b341b3da8bd
                    name: Weekly CFO hires
                    detection_mode: signal_first
                    record_unit: signal
                  metadata:
                    monitor_log_id: 516b72de-79d5-400b-9bae-423a43eca98b
                    parent_monitor_log_id: null
                    total_signals: 25
                    total_companies: 25
                    total_people: 0
                    window:
                      from: '2026-10-10T02:09:00.000Z'
                      to: '2026-10-17T06:09:56.270Z'
                      next_page_token: eyJhbGciOi…
                  triggered_at: '2026-10-17T06:20:11.002Z'
                  signals: []
                  pagination:
                    page: 2
                    per_page: 25
                    total_entries: 395
                    total_pages: 16
                    total_display_pages: 16
                    is_timeout: false
                    is_estimated: false
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    search_pagination:
      type: object
      description: الترقيم الصفحي لمجموعة النتائج.
      properties:
        page:
          type: integer
          description: رقم الصفحة الحالية.
        per_page:
          type: integer
          description: السجلات لكل صفحة.
        total_entries:
          type: integer
          description: >-
            إجمالي السجلات المطابقة. يكون تقديرًا عندما تكون `is_estimated`
            بقيمة `true`.
        total_pages:
          type: integer
          description: '`total_entries` مقسومة على `per_page`.'
        total_display_pages:
          type: integer
          description: >-
            عدد الصفحات لهذه النتيجة، بحدّ أقصى هو `max_display_search_page`
            الخاص بخطتك.
        is_estimated:
          type: boolean
          description: >-
            `true` عندما تكون `total_entries` تقديرًا لا عددًا دقيقًا. لا تستخدم
            إجماليًا تقديريًا لتحديد متى تتوقف عن التنقل بين الصفحات؛ توقف عندما
            تُعيد الصفحة صفوفًا أقل من `per_page`.
        is_timeout:
          type: boolean
          description: >-
            `true` عندما انتهت مهلة البحث. عندها تحتسب `total_entries` فقط
            الصفوف المُعادة حتى الآن، والصفحة الفارغة تعني أن البحث لم يكتمل، لا
            أنه لا توجد مطابقات.
  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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.