Skip to main content
GET
/
api
/
v2
/
news
جلب الأخبار
curl --request GET \
  --url 'https://api.benzinga.com/api/v2/news?token=' \
  --header 'accept: <accept>'
[
  {
    "author": "Benzinga Newsdesk",
    "body": "<string>",
    "channels": [
      {
        "name": "Technology"
      }
    ],
    "created": "Wed, 17 May 2017 14:20:15 -0400",
    "id": 123456,
    "image": [
      {
        "size": "large",
        "url": "https://cdn.benzinga.com/files/images/story/2024/example.jpg"
      }
    ],
    "original_id": 123,
    "stocks": [
      {
        "cusip": "037833100",
        "exchange": "NASDAQ",
        "isin": "US0378331005",
        "name": "AAPL"
      }
    ],
    "tags": [
      {
        "name": "Technology"
      }
    ],
    "teaser": "<string>",
    "title": "Apple Announces New iPhone",
    "updated": "Wed, 17 May 2017 14:20:15 -0400",
    "url": "https://www.benzinga.com/news/123456"
  }
]

Authorizations

​
token
string
query
required

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

Headers

​
accept
enum<string>
default:application/json
required

حدد تنسيق الاستجابة

Available options:
application/json,
application/xml

Query Parameters

​
page
integer
default:0

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

​
pageSize
integer
default:15

عدد النتائج التي يتم إرجاعها. الحد الأقصى: 100.

Required range: x <= 100
​
displayOutput
enum<string>
default:headline

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

Available options:
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 (تنازلي).

Available options:
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>
default:or

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

Available options:
and,
or
​
authors
string

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

​
content_types
string

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

​
format
enum<string>

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

Available options:
text
​
importance
enum<string>

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

Available options:
low,
medium,
high
​
region
string

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

Response

نجاح

​
author
string
Example:

"Benzinga Newsdesk"

​
body
string
​
channels
object[]
​
created
string
Example:

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

​
id
integer
Example:

123456

​
image
object[]
​
original_id
integer
​
stocks
object[]
​
tags
object[]
​
teaser
string
​
title
string
Example:

"Apple Announces New iPhone"

​
updated
string
Example:

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

​
url
string
Example:

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