[ search · endpoint ]واجهة بحث · البيانات المالية

واجهة بحث البيانات المالية للشركات

استعلم عن الميزانيات العمومية وقوائم الدخل وقوائم التدفق النقدي وتوزيعات الأرباح ومعاملات المطّلعين للشركات الأمريكية المدرجة من نقطة نهاية واحدة. JSON مهيّأ مسبقًا للتحليل الأساسي والعناية الواجبة وأبحاث الاستثمار المدعومة بالذكاء الاصطناعي.

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

[ 01 · live ]

جرّب بحث البيانات المالية مباشرة

أدخل مفتاح 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/financials

base

https://www.apipick.com

بحث دلالي عبر الميزانيات العمومية وقوائم الدخل وقوائم التدفق النقدي وتوزيعات الأرباح ومعاملات المطّلعين للشركات الأمريكية. يُعيد سجلات مرتّبة مع روابط مصدر جاهزة لـ 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/financials" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Apple balance sheet for the latest quarter",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "Apple balance sheet for the latest quarter",
  "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": 200,
  "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 ]

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

لماذا تبلغ التكلفة 200 رصيد لكل طلب؟

الأساسيات المنظَّمة — الميزانيات وقوائم الدخل والتدفق النقدي وتوزيعات الأرباح وإفصاحات المطّلعين — هي أغلى مجموعات البيانات من حيث الترخيص والتوحيد، لذا تُسعَّر نقطة النهاية بـ 200 رصيد (≈ 0.20 دولار لكل طلب). ولا تزال جزءًا يسيرًا من مقعد طرفية الأساسيات.

ما القوائم المُغطّاة؟

الميزانيات العمومية وقوائم الدخل وقوائم التدفق النقدي وتاريخ توزيعات الأرباح ومعاملات المطّلعين للشركات الأمريكية المدرجة. مرّر رمز السهم أو استعلامًا بلغة طبيعية؛ تُستعلم جميعها على التوازي.

أي الشركات؟

الشركات المدرجة في الولايات المتحدة. مرّر رمز السهم (مثل AAPL) أو اسم الشركة. لنص الإيداعات ونصوص مكالمات الأرباح، استخدم نقطة نهاية بحث إيداعات SEC.

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

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

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

GET /api/search/financials/tool-schema يُعيد تعريفات جاهزة للصق لدالة OpenAI واستخدام أداة Claude.