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

واجهة بحث تقويم الأرباح

استعلم عن تقويم الأرباح الأمريكي للحصول على مواعيد التقارير المرتقبة والأخيرة، وتقديرات EPS والإيرادات، وتوقيت ما قبل/بعد افتتاح السوق من نقطة نهاية واحدة. JSON مهيّأ مسبقًا للتداول القائم على الأحداث والأبحاث المالية المدعومة بالذكاء الاصطناعي.

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

ما هو واجهة بحث تقويم الأرباح؟

بحث دلالي في تقويم الأرباح الأمريكي. يُعيد أحداث التقارير مرتّبةً مع التقديرات والتوقيت، جاهزة لـ LLM في المرحلة التالية.

حقائق أساسية
نقطة النهاية
POST /api/search/earnings-calendar
المصادقة
مفتاح API · ترويسة x-api-key
التكلفة
120 رصيد / استدعاء
حد المعدل
30 طلب / دقيقة
الاستجابة
JSON منظَّم
[ 01 · live ]

جرّب بحث تقويم الأرباح مباشرة

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

auth · x-api-key

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

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

5 استعلامات نموذجية — انقر للتحميل
[ 02 · integrate ]

دليل التكامل

انسخ المقتطف، استبدل مفتاح API الخاص بك، ثم شغّله. يعمل مع أي عميل HTTP — أمثلة أدناه بـ cURL وJavaScript وPython.

spec
POST/api/search/earnings-calendar
base
https://www.apipick.com

بحث دلالي في تقويم الأرباح الأمريكي. يُعيد أحداث التقارير مرتّبةً مع التقديرات والتوقيت، جاهزة لـ LLM في المرحلة التالية.

المعاملات
querystringمطلوب

Natural-language search query

max_num_resultsintegerاختياري

1–5, default 5

relevance_thresholdnumberاختياري

0.0–1.0 quality filter

country_codestringاختياري

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

start_datestringاختياري

ISO date YYYY-MM-DD

end_datestringاختياري

ISO date YYYY-MM-DD

curl -X POST "https://www.apipick.com/api/search/earnings-calendar" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Nvidia upcoming earnings date",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
● 200 · الاستجابة
{
  "query": "Nvidia upcoming earnings date",
  "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 ]

حدود المعدل

يُطبَّق التقييد لكل مفتاح API، بنافذة منزلقة مدتها 60 ثانية. عند بلوغ الحد تحصل على رمز 429 نظيف مع ترويسة Retry-After.

معدل الطلبات

30req/min

لكل مفتاح API ولكل نقطة نهاية. نافذة منزلقة مدتها 60 ثانية.

التزامن

3concurrent

الحد الأقصى للطلبات الجارية المتزامنة لكل مفتاح API.

ترويسات الاستجابة
X-RateLimit-Limitالحد الأقصى للطلبات المسموح بها في الدقيقة
X-RateLimit-Remainingالطلبات المتبقية في النافذة الحالية
X-RateLimit-Resetعدد الثواني حتى إعادة ضبط النافذة الحالية
Retry-Afterعدد الثواني التي يجب انتظارها قبل إعادة المحاولة (عند 429 فقط)
● 429 · طلبات كثيرة جدًا
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 ]

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

01

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

بيانات تقويم الأرباح مملوكة ومنظَّمة وتُحدَّث باستمرار، ويُسعّرها المزوّد الأساسي بسعر مرتفع؛ وعند 120 رصيدًا (≈ 0.12 دولار لكل طلب) تظل أقل بكثير من محطّات بيانات السوق المخصّصة.

02

ماذا يُعيد؟

مواعيد التقارير الربعية المرتقبة والأخيرة، وتقديرات EPS والإيرادات، وتوقيت الإبلاغ (قبل افتتاح السوق أو بعده) للشركات الأمريكية المدرجة، مرتّبةً حسب صلتها باستعلامك.

03

بم يختلف هذا عن بحث SEC؟

يسترجع بحث SEC الإيداعات ونصوص المكالمات التاريخية؛ أما تقويم الأرباح فهو استشرافي — يُطلعك على الموعد المتوقَّع لإبلاغ الشركة وما يتوقّعه المحلّلون.

04

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

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

05

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

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

[ explore ]

استكشف واجهات بحث أخرى

البحث في الويب

بحث ويب دلالي فوري مبني لاستدعاء أدوات LLM. يُعيد عناوين وروابط ومقتطفات نظيفة مرتّبة، مهيّأة مسبقًا لاستهلاك الوكلاء. يدعم تصفية البلد والتاريخ.

البحث الإخباري

بحث إخباري فوري عبر كبرى المنصات. تصفية حسب نطاق التاريخ والبلد للاستفسارات الحساسة للوقت. مبني لإحاطات الصباح ووكلاء أخبار السوق وأنابيب RAG.

استخراج محتوى URL

استخرج محتوى نظيفًا قابلًا للقراءة من حتى 25 رابطًا في الاستدعاء الواحد. يزيل الإعلانات والقوائم والقوالب الجاهزة، ويُعيد نصًا بنمط Markdown جاهزًا لاستيعاب LLM. رصيدان لكل URL.

البحث الأكاديمي

ابحث في أوراق محكّمة وما قبل النشر عبر arXiv وPubMed وbioRxiv وmedRxiv من نقطة نهاية واحدة. مبنية لمراجعة الأدبيات بالذكاء الاصطناعي، وRAG على المتون العلمية، واستخراج الاستشهادات.

البحث السريري

ابحث في التجارب السريرية وملصقات أدوية FDA ونشاطات ChEMBL. مبنية للأبحاث الطبية وإعادة توظيف الأدوية وسير عمل دعم القرار السريري المدعوم بالذكاء الاصطناعي.

بحث إيداعات SEC

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

بحث براءات الاختراع

بحث دلالي في براءات الاختراع العالمية لدى USPTO وEPO وWIPO وكبرى المكاتب الوطنية. مبنية لأبحاث الفن السابق ومسح ملكية الفكرية والذكاء التنافسي المدعوم بالذكاء الاصطناعي.

بحث أسواق التنبؤ

ابحث في عقود أسواق Polymarket وKalshi حول السياسة والاقتصاد والرياضة والأحداث الجارية. مبنية لاسترداد التنبؤات الجماعية وإسناد الاحتمالات في إجابات LLM.

البحث القانوني للمملكة المتحدة

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

بحث الأمن السيبراني

ابحث في الثغرات المستغَلة المعروفة من CISA (KEV) وسجلات CVE من NVD ودرجات الاستغلال EPSS وتقنيات MITRE ATT&CK. مبني لفرز الثغرات واستخبارات التهديدات وعمليات الأمن المدعومة بالذكاء الاصطناعي.

بحث الأسواق

ابحث في الأسهم العالمية والأمريكية والعملات المشفّرة والفوركس وصناديق ETF والصناديق والسلع ومحرّكات السوق الأمريكية. مبني لاستعلامات الأسعار وبيانات السوق وأبحاث التداول المدعومة بالذكاء الاصطناعي.

بحث البيانات الاقتصادية

ابحث في FRED ومكتب إحصاءات العمل الأمريكي ومؤشرات البنك الدولي وبيانات صندوق النقد الدولي الكلية والإنفاق الفيدرالي الأمريكي وإحصاءات العمل الألمانية. مبني للأبحاث الاقتصادية الكلية المدعومة بالذكاء الاصطناعي.

بحث البيانات المالية

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

بحث الكيمياء

ابحث في نشاط ChEMBL الحيوي وبُنى PubChem الكيميائية وروابط الهدف-المرض في Open Targets. مبني لاكتشاف الأدوية والمعلوماتية الكيميائية والأبحاث الطبية الحيوية المدعومة بالذكاء الاصطناعي.

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

ابحث في NCBI Gene وdbSNP وClinVar وdbVar وMedGen وGTR عن الجينات والمتغيّرات ودلالاتها السريرية. مبني لأبحاث الجينوم وتفسير المتغيّرات المدعومة بالذكاء الاصطناعي.

بحث التسلسلات الجينومية

ابحث في NCBI Nucleotide وProtein وGenome وAssembly وCDD وStructure عن التسلسلات والتجميعات ونطاقات البروتين. مبني للمعلوماتية الحيوية المدعومة بالذكاء الاصطناعي.

بحث مجموعات البيانات الجينومية

ابحث في NCBI SRA وGEO وBioSample وBioProject وdbGaP وTaxonomy عن عمليات التسلسل ومجموعات بيانات التعبير وبيانات الكائنات الحية. مبني لاكتشاف بيانات الأوميكس المدعوم بالذكاء الاصطناعي.

بحث البيانات الصحية

ابحث في إحصاءات منظمة الصحة العالمية ومنح أبحاث NIH وتقارير الأحداث الدوائية الضائرة من openFDA. مبني لأبحاث الصحة العامة واكتشاف المنح واليقظة الدوائية المدعومة بالذكاء الاصطناعي.

بحث السياسة

ابحث في مناقشات البرلمان البريطاني والأسئلة الكتابية ونشاط الأعضاء (Hansard). مبني لأدوات التقنية المدنية ومراقبة التشريعات وأبحاث السياسات المدعومة بالذكاء الاصطناعي.

بحث Wiley Finance

ابحث في مجلات وكتب التمويل المرخّصة من Wiley. مبني للأبحاث المالية بمستوى أكاديمي ومراجعة الأدبيات وتحليل الاستثمار المدعومة بالذكاء الاصطناعي.