finlight Logo

Monday, July 13, 2026

الأخبار العالمية حسب الدولة والفئة مع finlight API

Kevin Bartsch

الأخبار العالمية حسب الدولة والفئة مع finlight API

الأسواق عالمية، لكن معظم واجهات الأخبار البرمجية تمنحك سيلًا غير مميَّز وبالإنجليزية فقط. يتيح لك finlight تقسيم التغطية وفق بُعدين، الدولة والفئة، وقراءتها بلغة السوق الذي يهمك.

التصفية حسب الفئة

كل مقال موسوم بواحدة أو أكثر من 13 فئة:

markets، economy، business، politics، geopolitics، regulation، technology، energy، commodities، crypto، health، climate، security

مرّر ما تريده منها في categories:

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "categories": ["technology", "crypto"],
    "pageSize": 20
  }'

التصفية حسب الدولة

تُوسَم المقالات أيضًا بالدول التي تؤثر فيها، باستخدام رموز ISO 3166-1 alpha-2 (US، GB، DE، JP، وهكذا). ادمج countries مع categories للتركيز بإحكام:

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "countries": ["US", "GB"],
    "categories": ["regulation"],
    "pageSize": 20
  }'

يُرجع هذا قصص التنظيم التي تؤثر في الولايات المتحدة والمملكة المتحدة. وتُربط مرشّحات الدولة والفئة بكل شيء آخر بـ AND، لذا يمكنك إضافة tickers أو نطاق زمني أو query فوقها.

اقرأها باللغة المحلية

يغطي finlight الأخبار بتسع لغات: الإنجليزية (en)، والصينية المبسطة (zh)، والهندية (hi)، والإسبانية (es)، واليابانية (ja)، والكورية (ko)، والبرتغالية (pt)، والعربية (ar)، والروسية (ru). اضبط الحقل language لاختيار التغطية بأي لغة تستعيدها (الافتراضي هو en):

# Python
from finlight_client import FinlightApi, ApiConfig
from finlight_client.models import GetArticlesParams

client = FinlightApi(config=ApiConfig(api_key="YOUR_API_KEY"))

params = GetArticlesParams(
    countries=["JP"],
    categories=["markets", "economy"],
    language="ja",
    pageSize=20,
)
response = client.articles.fetch_articles(params)

يُرجع هذا الطلب تغطية الأسواق والاقتصاد لليابان باللغة اليابانية، بدلًا من إجبارك على المرور عبر تقارير بالإنجليزية فقط.

لماذا يهم هذا

دمج الدولة والفئة واللغة يتيح لك بناء رؤى إقليمية حقيقية: سياسة الطاقة الألمانية بالألمانية، وتحركات السوق اليابانية باليابانية، والتنظيم الأمريكي بالإنجليزية. وبالنسبة لمكتب عالمي أو منتج متعدد المناطق، هذا هو الفرق بين تغطية محلية فعلية وتقريب مترجَم.

إلى أين تذهب بعد ذلك

احصل على مفتاح API المجاني ←