Saltar al contenido principal
GET
Error

Autorizaciones

token
string
query
requerido

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

Encabezados

accept
enum<string>
predeterminado:application/json
requerido

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

Opciones disponibles:
application/json,
application/xml

Parámetros de consulta

page
integer
predeterminado:0

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

pageSize
integer
predeterminado:15

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

Rango requerido: x <= 100
displayOutput
enum<string>
predeterminado:headline

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

Opciones disponibles:
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 (تنازلي)

Opciones disponibles:
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>
predeterminado:or

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

Opciones disponibles:
and,
or
authors
string

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

content_types
string

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

format
enum<string>

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

Opciones disponibles:
text
importance
string

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

region
string

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

Respuesta

نجاح

author
string
Ejemplo:

"Benzinga Newsdesk"

body
string
channels
object[]
created
string
Ejemplo:

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

id
integer
Ejemplo:

123456

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

"Apple Announces New iPhone"

updated
string
Ejemplo:

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

url
string
Ejemplo:

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