[ search · endpoint ]واجهة بحث · سريري

واجهة البحث السريري والصيدلاني

نقطة نهاية واحدة فوق ClinicalTrials.gov وملصقات أدوية FDA ونشاطات ChEMBL وصيدلة DrugBank. JSON مهيّأ مسبقًا لـ RAG الطبي وأنابيب إعادة توظيف الأدوية ودعم القرار السريري المدعوم بالذكاء الاصطناعي.

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

[ 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/clinical

base

https://www.apipick.com

بحث دلالي عبر ClinicalTrials.gov وملصقات FDA المعتمدة وChEMBL وDrugBank. يُعيد عناوين وملخصات وروابط مصدر جاهزة لـ 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/clinical" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "CAR-T therapy effectiveness in pediatric leukemia latest studies",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "CAR-T therapy effectiveness in pediatric leukemia latest studies",
  "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": 30,
  "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 ]

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

ما المصادر التي تُغطى؟

ClinicalTrials.gov (الدراسات المسجّلة)، ملصقات أدوية FDA (Structured Product Labeling)، ChEMBL (بيانات النشاط الحيوي)، وDrugBank (صيدلة الأدوية). تُستعلم الأربعة على التوازي.

هل هذه نصيحة طبية؟

لا. تكشف الواجهة عن قواعد بيانات عامة لأغراض البحث وسير عمل البرمجيات. المخرجات ليست نصيحة طبية، ولا يجوز استخدامها لاتخاذ قرارات سريرية دون وجود إنسان مؤهل في الحلقة.

هل يمكنني التقييد بنطاق تاريخ؟

نعم. مرّر start_date وend_date لتصفية التجارب وتحديثات الملصقات حسب التاريخ.

كيف تعمل الأرصدة مع الاستدعاءات الفاشلة؟

إذا فشل البحث (5xx) أو كان الاستعلام غير صالح (4xx)، لا تُخصم أرصدة. تُحاسب فقط على استجابة 2xx ناجحة.

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

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