واجهة API لأخبار الأسواق

ابدأ خلال 3 خطوات

1. 01

   أنشئ مفتاح API

   أنشئ مفتاحك من لوحة المطوّر وأرسله مع كل طلب.

2. 02

   أرسل طلباً

   أرسل GET /market-news مع المفتاح في ترويسة X-API-Key.

3. 03

   استلم البيانات

   كل قصة تعيد عناوين ثنائية اللغة وفئة وسوقاً ودرجات تأثير.

curl "https://www.brieflynewsstream.com/api/v1/market-news" \
  -H "X-API-Key: YOUR_KEY"

{
  "id": "...",
  "title": "أسواق الأسهم العالمية تتماسك مع ترقّب قرارات الفائدة",
  "summary": "الأسواق تبقى منتظمة بينما ينتظر المتعاملون الخطوة التالية في السياسة النقدية.",
  "arabic": {
    "title": "أسواق الأسهم العالمية تتماسك مع ترقّب قرارات الفائدة",
    "summary": "الأسواق تبقى منتظمة بينما ينتظر المتعاملون الخطوة التالية في السياسة النقدية."
  },
  "english": {
    "title": "Global equities hold as desks watch the next rate decision",
    "summary": "Stock markets stay orderly while traders wait for the next move in policy."
  },
  "category": "markets",
  "country": "GLOBAL",
  "publishedAt": "2026-08-21T12:00:00.000Z",
  "scores": {
    "final": 86,
    "marketImpact": 84
  }
}

المصادقة

أرسل مفتاح API في ترويسة X-API-Key مع كل طلب أخبار.

X-API-Key: YOUR_KEY

أنشئ المفاتيح من لوحة المطوّر.

Market News API

GET /market-news

استرجع أحدث الأخبار وفق الفلاتر التي يحتاجها منتجك.

نقاط النهاية العامة

Parameters

Example

GET /market-news?region=global&category=markets&sort=score&limit=10

بيانات مصممة للاستخدام البرمجي

كل قصة تستخدم الحقول نفسها.

{
  "id": "...",
  "title": "أسواق الأسهم العالمية تتماسك مع ترقّب قرارات الفائدة",
  "summary": "الأسواق تبقى منتظمة بينما ينتظر المتعاملون الخطوة التالية في السياسة النقدية.",
  "arabic": {
    "title": "أسواق الأسهم العالمية تتماسك مع ترقّب قرارات الفائدة",
    "summary": "الأسواق تبقى منتظمة بينما ينتظر المتعاملون الخطوة التالية في السياسة النقدية."
  },
  "english": {
    "title": "Global equities hold as desks watch the next rate decision",
    "summary": "Stock markets stay orderly while traders wait for the next move in policy."
  },
  "category": "markets",
  "country": "GLOBAL",
  "publishedAt": "2026-08-21T12:00:00.000Z",
  "scores": {
    "final": 86,
    "marketImpact": 84
  }
}

• العنوان

  title, arabic, english

  title يتبع lang. arabic وenglish يبقيان في الكائن نفسه.

• التصنيف

  category

  فئة سوق ثابتة مثل markets أو finance أو oil.

• السوق

  country, region

  country رمز ISO. region هي middle_east أو america أو global.

• التأثير

  scores.final, scores.marketImpact

  scores.final وscores.marketImpact ترتّبان أثر السوق المتوقع.

• التاريخ

  publishedAt

  publishedAt طابع زمني بصيغة ISO 8601.

فلترة الأخبار بالطريقة التي يحتاجها منتجك

GET /market-news
  ?region=global
  &category=finance
  &lang=ar
  &sort=score
  &limit=20

استخدم sort=score لترتيب الأخبار حسب درجة التأثير بدلاً من ترتيبها زمنياً فقط.

الاستجابة

JSON وUTF-8 وحقول عربية وإنجليزية وغلاف ثابت وترويسات الحصة مع كل استجابة مصادَقة.

• JSON بترميز utf-8
• حقول ثابتة لكل قصة
• title وsummary يتبعان lang. arabic وenglish يبقيان موجودين.
• صفّح بـ limit وoffset. count هو إجمالي القصص الفريدة.
• X-API-Quota-Limit وX-API-Quota-Remaining وX-API-Quota-Used.

{
  "meta": {
    "version": "1.0.0",
    "lang": "ar"
  },
  "count": 10,
  "limit": 10,
  "offset": 0,
  "items": []
}

الأخطاء

الأخطاء تعيد رمزاً مسطحاً ورسالة.

{
  "error": "unauthorized",
  "message": "Missing or invalid API key."
}

حدود الاستخدام

المجاني يشمل 3 طلبات يومياً. Pro يشمل 500. Enterprise يشمل 20,000 افتراضياً. يتجدد الحد اليومي تلقائياً كل يوم.

حجم الصفحة الافتراضي 50. الحد الأقصى 500.

من دون from أو to أو date تستخدم النتائج النافذة الحية الافتراضية لمدة 72 ساعة. القصص المفهرسة تبقى في الأرشيف على كل خطة. استخدم from وto للاستعلام أبعد.

استخدمها بالطريقة التي تناسب منتجك

const response = await fetch(
  "https://www.brieflynewsstream.com/api/v1/market-news",
  {
    headers: {
      "X-API-Key": process.env.BRIEFLY_API_KEY
    }
  }
);
const data = await response.json();

curl "https://www.brieflynewsstream.com/api/v1/market-news" \
  -H "X-API-Key: YOUR_KEY"

import os
import urllib.request

req = urllib.request.Request(
    "https://www.brieflynewsstream.com/api/v1/market-news",
    headers={"X-API-Key": os.environ["BRIEFLY_API_KEY"]},
)
with urllib.request.urlopen(req) as response:
    print(response.read().decode())

$ch = curl_init("https://www.brieflynewsstream.com/api/v1/market-news");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-API-Key: " . getenv("BRIEFLY_API_KEY"),
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);

جرّب الطلبات من اللوحة