> ## Documentation Index
> Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt
> Use this file to discover all available pages before exploring further.

# البيانات الصحفية

> تعيد واجهة برمجة التطبيقات API هذه القائمة على REST بيانات منظَّمة للبيانات الصحفية. للحصول على أفضل أداء، قصِّر نطاق الاستعلام باستخدام معلمات مثل رموز الأسهم والتاريخ والقنوات، أو استخدم updatedSince للحصول على التغييرات فقط. إزاحات الصفحات محدودة بين 0 و100000.

<ResponseExample>
  ```json استجابة (200 OK) theme={null}
  [
    {
      "id": 36444586,
      "author": "GlobeNewswire",
      "created": "Mon, 01 Jan 2024 13:35:14 -0400",
      "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
      "title": "شركة XYZ تعلن عن نتائج أرباح الربع الرابع لعام 2023 والمبادرات الاستراتيجية",
      "teaser": "",
      "body": "",
      "url": "https://www.benzinga.com/pressreleases/24/01/g36444586/company-xyz-announces-q4-2023-earnings-results-and-strategic-initiatives",
      "image": [
        {
          "size": "thumb",
          "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/press_release_image.jpeg"
        },
        {
          "size": "small",
          "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/press_release_image.jpeg"
        },
        {
          "size": "large",
          "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/press_release_image.jpeg"
        }
      ],
      "channels": [
        {
          "name": "البيانات الصحفية"
        }
      ],
      "stocks": [
        {
          "name": "AAPL",
          "cusip": "037833100",
          "isin": "US0378331005",
          "exchange": "NASDAQ"
        }
      ],
      "tags": [
        {
          "name": "بيان صحفي"
        }
      ]
    }
  ]
  ```

  ```json استجابة (401 Unauthorized) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "auth_failed",
        "id": "unauthorized",
        "value": "رمز الوصول للمصادقة غير صالح أو مفقود"
      }
    ]
  }
  ```

  ```json استجابة (404 Not Found) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "no_data_found",
        "id": "not_found",
        "value": "لم يتم العثور على أي بيانات للمعلمات المحددة"
      }
    ]
  }
  ```

  ```json استجابة (500 Internal Server Error) theme={null}
  {
    "ok": false,
    "errors": [
      {
        "code": "internal_server_error",
        "id": "server_error",
        "value": "حدث خطأ غير متوقع أثناء معالجة طلبك"
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml ar/openapi/press-releases_api.spec.yml GET /api/v2/news
openapi: 3.0.0
info:
  contact: {}
  description: مصادقة Bearer token
  title: Press Releases v2
  version: 2.0.0
servers:
  - url: https://api.benzinga.com
    description: PROD
security: []
paths:
  /api/v2/news:
    get:
      tags:
        - Press Releases
      summary: البيانات الصحفية
      description: >-
        تعيد واجهة برمجة التطبيقات API هذه القائمة على REST بيانات منظَّمة
        للبيانات الصحفية. للحصول على أفضل أداء، قصِّر نطاق الاستعلام باستخدام
        معلمات مثل رموز الأسهم والتاريخ والقنوات، أو استخدم updatedSince للحصول
        على التغييرات فقط. إزاحات الصفحات محدودة بين 0 و100000.
      operationId: get-press-releases
      parameters:
        - description: حدِّد تنسيق الإرجاع
          in: header
          name: accept
          required: true
          schema:
            type: string
            enum:
              - application/json
              - application/xml
            default: application/json
        - description: >-
            إزاحة الصفحة. لأسباب تتعلق بالتحسين والأداء والجوانب التقنية، تقتصر
            إزاحات الصفحات على نطاق من 0 إلى 100000. قلِّص نتائج الاستعلام
            باستخدام معلمات أخرى مثل التاريخ.
          in: query
          name: page
          schema:
            type: integer
            default: 0
        - description: عدد النتائج المُعادة. الحد الأقصى 100.
          in: query
          name: pageSize
          schema:
            type: integer
            maximum: 100
            default: 15
        - description: >-
            حدِّد العنوان فقط (headline)، أو العنوان + الموجز (abstract)، أو
            العنوان + النص الكامل (full)
          in: query
          name: displayOutput
          schema:
            type: string
            enum:
              - full
              - abstract
              - headline
            default: headline
        - description: >-
            التاريخ المطلوب الاستعلام عنه للأخبار. اختصار لـ dateFrom وdateTo
            إذا كانا متطابقين. التنسيق: yyyy-mm-dd
          in: query
          name: date
          schema:
            type: string
        - description: >-
            تاريخ بدء الاستعلام. يتم الترتيب حسب تاريخ النشر. التنسيق:
            yyyy-mm-dd
          in: query
          name: dateFrom
          schema:
            type: string
        - description: >-
            تاريخ انتهاء الاستعلام. يتم الترتيب حسب تاريخ النشر. التنسيق:
            yyyy-mm-dd
          in: query
          name: dateTo
          schema:
            type: string
        - description: آخر طابع زمني Unix ‏(UTC) للتحديث للسحب والترتيب بناءً عليه
          in: query
          name: updatedSince
          schema:
            type: integer
        - description: آخر طابع زمني Unix ‏(UTC) للنشر للسحب والترتيب بناءً عليه
          in: query
          name: publishedSince
          schema:
            type: integer
        - description: >-
            يتيح التحكم في فرز النتائج. القيمة الافتراضية هي created, DESC.
            التنسيق: field:direction. حقول الفرز: id, created, updated. ترتيب
            الفرز: asc (تصاعدي)، desc (تنازلي)
          in: query
          name: sort
          schema:
            type: string
            enum:
              - id:asc
              - id:desc
              - created:asc
              - created:desc
              - updated:asc
              - updated:desc
        - description: >-
            رقم التعريف الدولي للأوراق المالية ISIN واحد أو أكثر، مفصولة بفواصل.
            الحد الأقصى 50. التنسيق: csv
          in: query
          name: isin
          schema:
            type: string
        - description: >-
            قيمة CUSIP واحدة أو أكثر، مفصولة بفواصل. الحد الأقصى 50. يتطلب
            اتفاقية ترخيص. التنسيق: csv
          in: query
          name: cusips
          schema:
            type: string
        - description: 'رمز تداول واحد أو أكثر، مفصولة بفواصل. الحد الأقصى 50. التنسيق: csv'
          in: query
          name: tickers
          schema:
            type: string
        - description: >-
            رمز تداول أساسي واحد أو أكثر، مفصولة بفواصل. تُطبَّق التصفية حسب
            الارتباط برمز التداول الأساسي فقط. التنسيق: csv
          in: query
          name: primaryTickers
          schema:
            type: string
        - description: 'اسم قناة واحد أو أكثر أو معرّفات، مفصولة بفواصل. التنسيق: csv'
          in: query
          name: channels
          schema:
            type: string
        - description: >-
            كلمة أو عبارة واحدة أو أكثر، مفصولة بفواصل؛ يجري البحث في العنوان
            والوسوم والمتن حسب ترتيب الأولوية. التنسيق: csv
          in: query
          name: topics
          schema:
            type: string
        - description: >-
            المعامل المنطقي لاستعلام الموضوعات. استخدم 'and' لاشتراط جميع
            الموضوعات، و'or' لاشتراط أي موضوع
          in: query
          name: topic_group_by
          schema:
            type: string
            enum:
              - and
              - or
            default: or
        - description: 'مؤلف واحد أو أكثر، مفصولة بفواصل. التنسيق: csv'
          in: query
          name: authors
          schema:
            type: string
        - description: حدّد التنسيق المطلوب لاستجابة api
          in: query
          name: format
          schema:
            type: string
            enum:
              - text
        - description: التصفية حسب مستوى الأهمية
          in: query
          name: importance
          schema:
            type: string
            enum:
              - low
              - medium
              - high
        - description: 'التصفية حسب المنطقة (مثل: ''ca'' أو ''canada'' للمحتوى الكندي)'
          in: query
          name: region
          schema:
            type: string
      responses:
        '200':
          description: نجاح
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/api.NewsItem'
                type: array
            text/xml:
              schema:
                items:
                  $ref: '#/components/schemas/api.NewsItem'
                type: array
        '400':
          description: معلمات استعلام غير صالحة أو مفقودة
          content:
            application/json:
              schema:
                type: string
            text/xml:
              schema:
                type: string
        '499':
          description: تم إلغاء سياق الطلب
          content:
            application/json:
              schema:
                type: string
            text/xml:
              schema:
                type: string
        '500':
          description: خطأ داخلي
          content:
            application/json:
              schema:
                type: string
            text/xml:
              schema:
                type: string
      security:
        - ApiKeyAuth: []
components:
  schemas:
    api.NewsItem:
      description: عنصر خبر يتضمن بيانات وصفية كاملة
      properties:
        author:
          example: Benzinga Newsdesk
          type: string
        body:
          type: string
        channels:
          items:
            $ref: '#/components/schemas/api.ChannelTag'
          type: array
        created:
          example: Wed, 17 May 2017 14:20:15 -0400
          type: string
        id:
          example: 123456
          type: integer
        image:
          items:
            $ref: '#/components/schemas/api.Image'
          type: array
        original_id:
          type: integer
        stocks:
          items:
            $ref: '#/components/schemas/api.Stock'
          type: array
        tags:
          items:
            $ref: '#/components/schemas/api.ChannelTag'
          type: array
        teaser:
          type: string
        title:
          example: Apple Announces New iPhone
          type: string
        updated:
          example: Wed, 17 May 2017 14:20:15 -0400
          type: string
        url:
          example: https://www.benzinga.com/news/123456
          type: string
      type: object
    api.ChannelTag:
      description: اسم القناة أو الوسم
      properties:
        name:
          example: Technology
          type: string
      type: object
    api.Image:
      description: صورة الخبر مع الحجم وURL
      properties:
        size:
          example: large
          type: string
        url:
          example: https://cdn.benzinga.com/files/images/story/2024/example.jpg
          type: string
      type: object
    api.Stock:
      description: معلومات السهم مع رمز التداول والمُعرّفات
      properties:
        cusip:
          example: '037833100'
          type: string
        exchange:
          example: NASDAQ
          type: string
        isin:
          example: US0378331005
          type: string
        name:
          example: AAPL
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: >-
        مصادقة مفتاح واجهة برمجة التطبيقات API. قدِّم مفتاح API الخاص بك كمعلمة
        استعلام.
      in: query
      name: token
      type: apiKey

````