الانتقال إلى المحتوى الرئيسي
GET
/
api
/
v2
/
news
البيانات الصحفية
curl --request GET \
  --url 'https://api.benzinga.com/api/v2/news?token=' \
  --header 'accept: <accept>'
[
  {
    "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": "بيان صحفي"
      }
    ]
  }
]

[
  {
    "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": "بيان صحفي"
      }
    ]
  }
]

التفويضات

​
token
string
query
مطلوب

مصادقة مفتاح واجهة برمجة التطبيقات API. قدِّم مفتاح API الخاص بك كمعلمة استعلام.

الترويسات

​
accept
enum<string>
افتراضي:application/json
مطلوب

حدِّد تنسيق الإرجاع

الخيارات المتاحة:
application/json,
application/xml

معلمات الاستعلام

​
page
integer
افتراضي:0

إزاحة الصفحة. لأسباب تتعلق بالتحسين والأداء والجوانب التقنية، تقتصر إزاحات الصفحات على نطاق من 0 إلى 100000. قلِّص نتائج الاستعلام باستخدام معلمات أخرى مثل التاريخ.

​
pageSize
integer
افتراضي:15

عدد النتائج المُعادة. الحد الأقصى 100.

النطاق المطلوب: x <= 100
​
displayOutput
enum<string>
افتراضي:headline

حدِّد العنوان فقط (headline)، أو العنوان + الموجز (abstract)، أو العنوان + النص الكامل (full)

الخيارات المتاحة:
full,
abstract,
headline
​
date
string

التاريخ المطلوب الاستعلام عنه للأخبار. اختصار لـ dateFrom وdateTo إذا كانا متطابقين. التنسيق: yyyy-mm-dd

​
dateFrom
string

تاريخ بدء الاستعلام. يتم الترتيب حسب تاريخ النشر. التنسيق: yyyy-mm-dd

​
dateTo
string

تاريخ انتهاء الاستعلام. يتم الترتيب حسب تاريخ النشر. التنسيق: yyyy-mm-dd

​
updatedSince
integer

آخر طابع زمني Unix ‏(UTC) للتحديث للسحب والترتيب بناءً عليه

​
publishedSince
integer

آخر طابع زمني Unix ‏(UTC) للنشر للسحب والترتيب بناءً عليه

​
sort
enum<string>

يتيح التحكم في فرز النتائج. القيمة الافتراضية هي created, DESC. التنسيق: field:direction. حقول الفرز: id, created, updated. ترتيب الفرز: asc (تصاعدي)، desc (تنازلي)

الخيارات المتاحة:
id:asc,
id:desc,
created:asc,
created:desc,
updated:asc,
updated:desc
​
isin
string

رقم التعريف الدولي للأوراق المالية ISIN واحد أو أكثر، مفصولة بفواصل. الحد الأقصى 50. التنسيق: csv

​
cusips
string

قيمة CUSIP واحدة أو أكثر، مفصولة بفواصل. الحد الأقصى 50. يتطلب اتفاقية ترخيص. التنسيق: csv

​
tickers
string

رمز تداول واحد أو أكثر، مفصولة بفواصل. الحد الأقصى 50. التنسيق: csv

​
primaryTickers
string

رمز تداول أساسي واحد أو أكثر، مفصولة بفواصل. تُطبَّق التصفية حسب الارتباط برمز التداول الأساسي فقط. التنسيق: csv

​
channels
string

اسم قناة واحد أو أكثر أو معرّفات، مفصولة بفواصل. التنسيق: csv

​
topics
string

كلمة أو عبارة واحدة أو أكثر، مفصولة بفواصل؛ يجري البحث في العنوان والوسوم والمتن حسب ترتيب الأولوية. التنسيق: csv

​
topic_group_by
enum<string>
افتراضي:or

المعامل المنطقي لاستعلام الموضوعات. استخدم 'and' لاشتراط جميع الموضوعات، و'or' لاشتراط أي موضوع

الخيارات المتاحة:
and,
or
​
authors
string

مؤلف واحد أو أكثر، مفصولة بفواصل. التنسيق: csv

​
content_types
string
افتراضي:accesswire_story,accesswire_pr,businesswire_story,newswire_pressreleases,newswire_story,globenewswire_story,newsfile_story

نوع محتوى واحد أو أكثر، مفصولة بفواصل. التنسيق: csv

​
format
enum<string>

حدِّد التنسيق المطلوب لاستجابة api

الخيارات المتاحة:
text
​
importance
enum<string>

التصفية حسب مستوى الأهمية

الخيارات المتاحة:
low,
medium,
high
​
region
string

التصفية حسب المنطقة (مثل 'ca' أو 'canada' للمحتوى الكندي)

الاستجابة

نجاح

​
author
string
مثال:

"Benzinga Newsdesk"

​
body
string
​
channels
object[]
​
created
string
مثال:

"Wed, 17 May 2017 14:20:15 -0400"

​
id
integer
مثال:

123456

​
image
object[]
​
original_id
integer
​
stocks
object[]
​
tags
object[]
​
teaser
string
​
title
string
مثال:

"Apple Announces New iPhone"

​
updated
string
مثال:

"Wed, 17 May 2017 14:20:15 -0400"

​
url
string
مثال:

"https://www.benzinga.com/news/123456"