جميع واجهات API

واجهة API للبحث عن الشركات

ابحث عن شركات SEC بالاسم أو رمز التداول أو CIK.

الطلب الأول

البدء السريع
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies?query=AAPL&limit=20" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
استجابة نموذجية استجابة توضيحية · ليست طلبًا مباشرًا
{
  "query": "AAPL",
  "companies": [
    {
      "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
      "name": "Apple Inc.",
      "cik": "0000320193",
      "listings": [
        {
          "ticker": "AAPL",
          "exchange": "Nasdaq"
        }
      ]
    }
  ],
  "next_cursor": null,
  "as_of": "2026-08-29T12:00:00Z"
}

نقاط النهاية

GETالبحث عن الشركات/v1/companies
query
اسم الشركة أو Ticker أو CIK المكوّن من عشرة أرقام. المطابقة بالاسم وTicker غير حساسة لحالة الأحرف.
limit
الحد الأقصى للشركات المعادة. الافتراضي 20.
cursor
رمز المتابعة من الصفحة السابقة. وهو مرتبط بالاستعلام والمرشحات الأصلية.

MCP · companies_search

مرجع API

المصادر والمنهجية

بيانات SEC الوصفية الرسمية

المصدر هو هيئة الأوراق المالية والبورصات الأميركية. يستخدم Narwhal ارتباطات الشركات وبيانات وصفية للإرسالات وفهارس إيداعات EDGAR.

اقرأ المنهجية

هوية ثابتة

يبقى معرّف الشركة الواحد ثابتًا عند تغير الأسماء أو الرموز.

البيانات الوصفية للإيداع

تبقى النماذج والتواريخ والتعديلات وروابط SEC صريحة.

CIK مقابل رمز التداول

الأسئلة الشائعة

ما الذي تتضمنه الاستجابة؟

ابحث عن مُصدر SEC مشمول بالاسم أو Ticker أو CIK ذي العشرة أرقام.

ما نطاق التغطية المتاح؟

تُستمد مجموعة الإطلاق من لقطة معتمدة لارتباط رموز التداول بمعرّفات CIK لدى SEC. رمز التداول المُعاد اسم بديل، وليس دليلًا على إدراج نشط.

هل يتضمن نص الإيداع أو حقائق XBRL؟

لا. يغطي هذا العقد هوية الشركة وبيانات الإيداع الوصفية فقط.

أجرِ أول طلب لك

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