الأخبار

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

GET /api/v2/news

جلب الأخبار

cURL

curl --request GET \
  --url 'https://api.benzinga.com/api/v2/news?token=' \
  --header 'accept: <accept>'

استجابة (200 OK)

[
  {
    "id": 36444586,
    "author": "Benzinga Insights",
    "created": "Mon, 01 Jan 2024 13:35:14 -0400",
    "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
    "title": "10 Information Technology Stocks With Whale Alerts In Today's Session",
    "teaser": "",
    "body": "",
    "url": "https://www.benzinga.com/markets/options/24/01/36444586/10-information-technology-stocks-with-whale-alerts-in-todays-session",
    "image": [
      {
        "size": "thumb",
        "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/options_image_2.jpeg"
      }
    ],
    "channels": [
      {
        "name": "Options"
      }
    ],
    "stocks": [
      {
        "name": "AAPL",
        "cusip": "037833100",
        "isin": "US0378331005",
        "exchange": "NASDAQ"
      },
      {
        "name": "CLSK",
        "cusip": "18452B209",
        "isin": "US18452B2097",
        "exchange": "NASDAQ"
      },
      {
        "name": "NVDA",
        "cusip": "67066G104",
        "isin": "US67066G1040",
        "exchange": "NASDAQ"
      },
      {
        "name": "ORCL",
        "cusip": "68389X105",
        "isin": "US68389X1054",
        "exchange": "NYSE"
      },
      {
        "name": "TSM",
        "cusip": "874039100",
        "isin": "US8740391003",
        "exchange": "NYSE"
      }
    ],
    "tags": [
      {
        "name": "BZI-AUOA"
      }
    ]
  }
]

استجابة (200 OK)

[
  {
    "id": 36444586,
    "author": "Benzinga Insights",
    "created": "Mon, 01 Jan 2024 13:35:14 -0400",
    "updated": "Mon, 01 Jan 2024 13:35:15 -0400",
    "title": "10 Information Technology Stocks With Whale Alerts In Today's Session",
    "teaser": "",
    "body": "",
    "url": "https://www.benzinga.com/markets/options/24/01/36444586/10-information-technology-stocks-with-whale-alerts-in-todays-session",
    "image": [
      {
        "size": "thumb",
        "url": "https://cdn.benzinga.com/files/imagecache/250x187xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "small",
        "url": "https://cdn.benzinga.com/files/imagecache/1024x768xUP/images/story/2023/options_image_2.jpeg"
      },
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/imagecache/2048x1536xUP/images/story/2023/options_image_2.jpeg"
      }
    ],
    "channels": [
      {
        "name": "Options"
      }
    ],
    "stocks": [
      {
        "name": "AAPL",
        "cusip": "037833100",
        "isin": "US0378331005",
        "exchange": "NASDAQ"
      },
      {
        "name": "CLSK",
        "cusip": "18452B209",
        "isin": "US18452B2097",
        "exchange": "NASDAQ"
      },
      {
        "name": "NVDA",
        "cusip": "67066G104",
        "isin": "US67066G1040",
        "exchange": "NASDAQ"
      },
      {
        "name": "ORCL",
        "cusip": "68389X105",
        "isin": "US68389X1054",
        "exchange": "NYSE"
      },
      {
        "name": "TSM",
        "cusip": "874039100",
        "isin": "US8740391003",
        "exchange": "NYSE"
      }
    ],
    "tags": [
      {
        "name": "BZI-AUOA"
      }
    ]
  }
]

التفويضات

token · string · query · مطلوب

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

الترويسات

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

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

format · enum<string>

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

الخيارات المتاحة: text

importance · enum<string>

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

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

region · string

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

الاستجابة

200

application/json

نجاح

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"