البيانات الصحفية - Benzinga API Documentation

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

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

import requests

url = "https://api.benzinga.com/api/v2/news?token="

headers = {"accept": "<accept>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {accept: '<accept>'}};

fetch('https://api.benzinga.com/api/v2/news?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.benzinga.com/api/v2/news?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: <accept>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.benzinga.com/api/v2/news?token="

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "<accept>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.benzinga.com/api/v2/news?token=")
  .header("accept", "<accept>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v2/news?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'

response = http.request(request)
puts response.read_body

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

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "رمز الوصول للمصادقة غير صالح أو مفقود"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "لم يتم العثور على أي بيانات للمعلمات المحددة"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "حدث خطأ غير متوقع أثناء معالجة طلبك"
    }
  ]
}

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

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

GET

api

news

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

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

import requests

url = "https://api.benzinga.com/api/v2/news?token="

headers = {"accept": "<accept>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {accept: '<accept>'}};

fetch('https://api.benzinga.com/api/v2/news?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.benzinga.com/api/v2/news?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: <accept>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.benzinga.com/api/v2/news?token="

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "<accept>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.benzinga.com/api/v2/news?token=")
  .header("accept", "<accept>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v2/news?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'

response = http.request(request)
puts response.read_body

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

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "رمز الوصول للمصادقة غير صالح أو مفقود"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "لم يتم العثور على أي بيانات للمعلمات المحددة"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "حدث خطأ غير متوقع أثناء معالجة طلبك"
    }
  ]
}

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

{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "رمز الوصول للمصادقة غير صالح أو مفقود"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "لم يتم العثور على أي بيانات للمعلمات المحددة"
    }
  ]
}

{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "حدث خطأ غير متوقع أثناء معالجة طلبك"
    }
  ]
}

التفويضات

token

string

query

مطلوب

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

الترويسات

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

format

enum<string>

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

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

text

importance

enum<string>

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

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

low,

medium,

high

region

string

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

الاستجابة

نجاح

author

string

مثال:

"Benzinga Newsdesk"

body

string

channels

object[]

Show child attributes

created

string

مثال:

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

integer

مثال:

123456

image

object[]

Show child attributes

original_id

integer

stocks

object[]

Show child attributes