> ## 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 محدد.



## OpenAPI

````yaml ar-openapi POST /monitors/statistics/logs
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/statistics/logs:
    post:
      tags:
        - Monitor
      summary: سرد سجلات إحصاءات Monitor
      description: استرجع قائمة مرقّمة صفحيًا من سجلات الاكتشاف لـ Monitor محدد.
      operationId: monitors_list_statistics_logs
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                monitor_id:
                  type: string
                  format: uuid
                  description: المعرّف الفريد للـ Monitor المراد استرجاع سجلاته.
                monitor_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  description: التصفية إلى سجلات هذه الـ Monitors.
                monitor_log_ids:
                  type: array
                  items:
                    type: string
                    format: uuid
                  description: التصفية إلى إدخالات السجل المحددة هذه.
                search_term:
                  type: string
                  description: >-
                    عبارة بحث تُطابَق مقابل error_message وdestination_type
                    وdetection_mode (سلسلة فرعية غير حساسة لحالة الأحرف).
                start_date:
                  type: string
                  format: date
                  description: >-
                    بداية نطاق تاريخ created_at (سلسلة تاريخ ISO). تُستخدم مع
                    end_date.
                end_date:
                  type: string
                  format: date
                  description: >-
                    نهاية نطاق تاريخ created_at (سلسلة تاريخ ISO). تُستخدم مع
                    start_date.
                order_by:
                  type: string
                  enum:
                    - created_at
                    - total_credit
                    - processing_time_ms
                    - total_signals
                    - status
                    - retry_attempt
                  description: الحقل المُستخدَم للترتيب. القيمة الافتراضية created_at.
                  default: created_at
                is_ascending_order:
                  type: boolean
                  description: الترتيب تصاعديًا. القيمة الافتراضية false (تنازلي).
                  default: false
                statuses:
                  type: array
                  items:
                    type: string
                  description: >-
                    التصفية حسب حالة التفعيل (مثل 'success'، 'failure'). تقبل
                    أيضًا القيمة الوهمية 'recovered' — التفعيلات الفاشلة التي
                    نجحت إعادة محاولتها لاحقًا.
                signal_types:
                  type: array
                  items:
                    type: string
                  description: >-
                    التصفية إلى السجلات التي تتضمن أنواع إشاراتها أيًا من هذه
                    القيم.
                destination_types:
                  type: array
                  items:
                    type: string
                  description: التصفية حسب أنواع الوجهات (مثل ['email', 'webhook']).
                detection_modes:
                  type: array
                  items:
                    type: string
                  description: >-
                    التصفية حسب أوضاع الاكتشاف (مثل ['company_first',
                    'signal_first']).
                per_page:
                  type: integer
                  description: >-
                    السجلات لكل صفحة. القيمة الافتراضية 25، وهي أيضًا السقف في
                    معظم الخطط — الحد هو `max_search_per_page` الخاص باشتراكك،
                    الذي تُعيده
                    [Profile](/ar/api-reference/endpoint/profile/profile).
                    تجاوزه يُعيد **HTTP 416** برمز `41676` (أو `41613` في بحث
                    الشركات والأشخاص)، لا مجموعة نتائج مقتطَعة.
                  default: 25
                page:
                  type: integer
                  description: >-
                    رقم الصفحة، بدءًا من 1. السقف هو `max_search_page` الخاص
                    باشتراكك (`max_company_search_page` لبحث الشركات)، الذي
                    تُعيده
                    [Profile](/ar/api-reference/endpoint/profile/profile).
                    تجاوزه يُعيد **HTTP 416**.
                  default: 1
      responses:
        '200':
          description: >-
            استجابة ناجحة. الغلاف هو `{ metadata: { filters }, data: {
            pagination, monitor_logs } }` — تعرض `metadata.filters` المرشحات
            التي طُبِّقت على البحث.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    properties:
                      filters:
                        type: object
                        description: عرض للمرشحات المطبَّقة على هذا البحث.
                  data:
                    type: object
                    properties:
                      pagination:
                        type: object
                        properties:
                          page:
                            type: integer
                            description: رقم الصفحة الحالية.
                          per_page:
                            type: integer
                            description: عدد النتائج لكل صفحة.
                          total_entries:
                            type: integer
                            description: العدد الإجمالي لإدخالات السجل.
                          total_pages:
                            type: integer
                            description: العدد الإجمالي للصفحات.
                          total_display_pages:
                            type: integer
                            description: العدد الإجمالي لصفحات العرض.
                          is_timeout:
                            type: boolean
                            description: ما إذا انتهت مهلة الاستعلام.
                      monitor_logs:
                        type: array
                        items:
                          type: object
                          properties:
                            monitor_log_id:
                              type: string
                              format: uuid
                              description: معرّف فريد لإدخال السجل هذا.
                            monitor_id:
                              type: string
                              format: uuid
                              description: معرّف الـ Monitor الذي أنتج هذا السجل.
                            parent_monitor_log_id:
                              type: string
                              description: >-
                                معرّف إدخال السجل الأصل، إن كان هذا إعادة
                                محاولة.
                            detection_mode:
                              type: string
                              description: >-
                                وضع الاكتشاف المستخدَم. إما 'company_first' أو
                                'signal_first'.
                            signal_type:
                              type: array
                              items:
                                type: string
                              description: >-
                                أنواع الإشارات المراقَبة (مثل 'jobs'، 'news'،
                                'advertisements').
                            destination_type:
                              type: string
                              description: نوع وجهة التسليم (مثل 'email'، 'webhook').
                            response_status_code:
                              type: integer
                              description: رمز حالة HTTP من استجابة الوجهة.
                            status:
                              type: string
                              description: حالة تنفيذ التفعيل (مثل 'success'، 'failed').
                            error_message:
                              type: string
                              description: >-
                                رسالة الخطأ إن فشل التفعيل. سلسلة فارغة عند
                                النجاح.
                            total_signals:
                              type: integer
                              description: العدد الإجمالي للإشارات المكتشَفة.
                            total_companies:
                              type: integer
                              description: العدد الإجمالي للشركات الموجودة.
                            total_people:
                              type: integer
                              description: العدد الإجمالي للأشخاص الموجودين.
                            trigger_credit:
                              type: integer
                              description: الأرصدة المستهلَكة للتفعيل نفسه.
                            total_company_credit:
                              type: integer
                              description: الأرصدة المستهلَكة لإثراء الشركة.
                            total_people_credit:
                              type: integer
                              description: الأرصدة المستهلَكة لإثراء الأشخاص.
                            redeem_email_credit:
                              type: integer
                              description: الأرصدة المستهلَكة لاستبدال البريد الإلكتروني.
                            redeem_phone_credit:
                              type: integer
                              description: الأرصدة المستهلَكة لاستبدال الهاتف.
                            total_credit:
                              type: integer
                              description: إجمالي الأرصدة المستهلَكة لهذا التفعيل.
                            retry_attempt:
                              type: integer
                              description: عدد محاولات إعادة المحاولة المُنفَّذة.
                            processing_time_ms:
                              type: integer
                              description: إجمالي وقت المعالجة بالمللي ثانية.
                            created_at:
                              type: string
                              format: date-time
                              description: الطابع الزمني عند إنشاء إدخال السجل.
                            retry_logs:
                              type: array
                              items:
                                type: object
                              description: مصفوفة من إدخالات سجل إعادة المحاولة، إن وُجدت.
                            is_retry_succeed:
                              type: boolean
                              description: ما إذا نجحت محاولة إعادة المحاولة.
              example:
                metadata:
                  filters:
                    statuses:
                      - failure
                    language: en
                data:
                  pagination:
                    page: 1
                    per_page: 25
                    total_entries: 45
                    total_pages: 2
                    total_display_pages: 2
                    is_timeout: false
                  monitor_logs:
                    - monitor_log_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                      monitor_id: b2c3d4e5-f6a7-8901-bcde-f12345678901
                      parent_monitor_log_id: ''
                      detection_mode: company_first
                      signal_type:
                        - jobs
                        - news
                        - advertisements
                      destination_type: email
                      response_status_code: 200
                      status: success
                      error_message: ''
                      total_signals: 25
                      total_companies: 11
                      total_people: 32
                      trigger_credit: 15
                      total_company_credit: 11
                      total_people_credit: 33
                      redeem_email_credit: 0
                      redeem_phone_credit: 0
                      total_credit: 59
                      retry_attempt: 0
                      processing_time_ms: 97952
                      created_at: '2026-04-05T18:28:05.000Z'
                      retry_logs: []
                      is_retry_succeed: false
                    - ...
        '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

````