[ search · endpoint ]واجهة بحث · أكاديمي

واجهة البحث الأكاديمي

استعلم عن الأوراق المحكّمة وما قبل النشر عبر arXiv وPubMed وbioRxiv وmedRxiv من نقطة نهاية واحدة. مخرجات JSON مهيّأة مسبقًا جاهزة لاستدعاء أدوات LLM واستخراج الاستشهادات وRAG على الأدبيات العلمية.

●5 رصيد / استدعاء●60 طلب / دقيقةPOST /api/search/academic

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

base

https://www.apipick.com

بحث دلالي عبر arXiv وPubMed وbioRxiv وmedRxiv. يُعيد عناوين مرتّبة وملخصات وروابط مصدر جاهزة لاستيعاب 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/academic" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Latest breakthroughs in CRISPR gene editing",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "Latest breakthroughs in CRISPR gene editing",
  "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": 5,
  "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

60req/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: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

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

[ faq ]

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

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

arXiv (علوم الحاسوب والرياضيات والفيزياء وغيرها)، PubMed (الطب الحيوي)، bioRxiv (مسبقات النشر البيولوجية)، وmedRxiv (مسبقات النشر الطبية). تُستعلم الأربعة على التوازي في استدعاء واحد.

لماذا أرخص من واجهات بحث رأسية أخرى؟

الفهارس الأكاديمية مفتوحة الوصول (arXiv، PubMed، bioRxiv، medRxiv) رخيصة الاستعلام نسبيًا مقارنة بمجموعات بيانات مالية أو قانونية محتكرة. وسعر الأرصدة يعكس ذلك.

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

نعم. مرّر start_date وend_date بصيغة YYYY-MM-DD للتصفية حسب تاريخ النشر.

هل تُعاد النصوص الكاملة للأوراق؟

لا — تشمل النتائج العنوان ومقتطفًا بأسلوب ملخص ورابط المصدر ودرجة الصلة. استخدم POST /api/extract على رابط المصدر لجلب المحتوى الكامل لأي ورقة.

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

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