[ search · endpoint ]واجهة بحث · SEC

واجهة بحث إيداعات SEC والبيانات المالية الأمريكية

استعلم عن إيداعات SEC (10-K و10-Q و8-K) ونصوص مكالمات الأرباح الأمريكية وإحصاءات الأسهم من نقطة نهاية واحدة. JSON مهيّأ مسبقًا للعناية الواجبة المدفوعة بالذكاء الاصطناعي والتحليل الأساسي وRAG المالي.

●120 رصيد / استدعاء●30 طلب / دقيقةPOST /api/search/sec

[ 01 · live ]

جرّب بحث SEC مباشرةً

أدخل مفتاح API الخاص بك ونفّذ استعلامًا حقيقيًا على نقطة النهاية المباشرة.

auth · x-api-key

مفتاح API

لا تملك مفتاح API؟

سجّل الدخول إلى حسابك لإنشاء وإدارة مفاتيح API.

تسجيل الدخول إدارة مفاتيح API

[ 02 · integrate ]

Integration guide

Copy a snippet, replace your API key, run. Works in any HTTP client — examples below in cURL, JavaScript, and Python.

spec

POST/api/search/sec

base

https://www.apipick.com

بحث دلالي في إيداعات SEC EDGAR ونصوص الأرباح الأمريكية وإحصاءات الأسهم. يُعيد فقرات مرتّبة مع روابط مصدر جاهزة لـ LLM في المرحلة التالية.

parameters

querystringrequired

Natural-language search query

max_num_resultsintegeroptional

1–5, default 5

relevance_thresholdnumberoptional

0.0–1.0 quality filter

country_codestringoptional

ISO country code (e.g. US, GB)

start_datestringoptional

ISO date YYYY-MM-DD

end_datestringoptional

ISO date YYYY-MM-DD

curl -X POST "https://www.apipick.com/api/search/sec" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Latest Nvidia statistics",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "Latest Nvidia statistics",
  "results": [
    {
      "title": "Example result",
      "url": "https://example.com/article",
      "snippet": "Short excerpt of the page content…",
      "source_type": "web",
      "published_at": "2026-04-15",
      "score": 0.92
    }
  ],
  "result_count": 1,
  "credits_used": 120,
  "remaining_credits": 99
}

[ 03 · limits ]

Rate limits

Throttling is per API key, sliding 60-second window. Hit the limit and you get a clean 429 with a Retry-After header.

request rate

30req/min

Per API key, per endpoint. Sliding 60-second window.

concurrency

3concurrent

Max simultaneous in-flight requests per API key.

response headers

X-RateLimit-LimitMaximum requests allowed per minute

X-RateLimit-RemainingRequests remaining in the current window

X-RateLimit-ResetSeconds until the current window resets

Retry-AfterSeconds to wait before retrying (only on 429)

● 429 · too many requests

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

[ faq ]

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

لماذا 120 رصيدًا للاستدعاء بدلًا من 15 لبحث الويب؟

إيداعات SEC EDGAR ونصوص الأرباح الأمريكية وإحصاءات الأسهم بيانات محتكرة، ومكلفة الترخيص، وتتطلب صيانة فهرس مستمرة. سعر 120 رصيدًا (≈ 0.12 $ للاستدعاء) يعكس ذلك — وهو لا يزال جزءًا بسيطًا مما تتقاضاه منصات تحليل SEC المخصّصة لمقعد API.

ما أنواع الإيداعات المُغطاة؟

كل إيداعات EDGAR — 10-K و10-Q و8-K وS-1 وبيانات الوكالة، وغيرها — بالإضافة إلى نصوص مكالمات الأرباح الأمريكية وإحصاءات الأسهم المحسوبة. مرّر رمز السهم أو اسم الشركة أو استعلامًا بلغة طبيعية.

هل يمكنني الحصول على النص الكامل للإيداع؟

تشمل النتائج فقرات مع روابط مصدر. لجلب الوثيقة كاملة، تابع بـ POST /api/extract على الرابط — تحصل على Markdown نظيف جاهز لاستيعاب LLM.

تصفية حسب التاريخ؟

نعم. مرّر start_date وend_date بصيغة YYYY-MM-DD لتقييد النتائج بنافذة إيداع محدّدة.

مخطط أداة لـ OpenAI / Claude؟

GET /api/search/sec/tool-schema يُعيد تعريفات OpenAI function وtool use في Claude جاهزة للصق.