apipick
[ search · endpoint ]واجهة بحث · أخبار

واجهة بحث إخباري لوكلاء الذكاء الاصطناعي

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

●15 رصيد / استدعاء●60 طلب / دقيقةPOST /api/search/news
[ 01 · live ]

جرّب البحث الإخباري مباشرةً

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

auth · x-api-key

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

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

تسجيل الدخولإدارة مفاتيح API
5 استعلامات نموذجية — انقر للتحميل
[ 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/news
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/news" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "artificial intelligence regulation updates",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
● 200 · response
{
  "query": "artificial intelligence regulation updates",
  "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": 15,
  "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 ]

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

01

ما مدى حداثة النتائج؟

تشمل النتائج مقالات فُهرست في الدقائق الأخيرة. استخدم start_date / end_date لتحديد نافذة معيّنة، مثل آخر 24 ساعة للأخبار العاجلة أو آخر ربع لتغطية الأرباح.

02

هل يمكنني التصفية حسب البلد؟

نعم. يقبل country_code رموز ISO 3166-1 alpha-2 (US، GB، JP، DE…). يحيّز النتائج نحو المصادر من ذلك البلد.

03

ما الفرق عن /api/search/web؟

نقطة نهاية الأخبار مضبوطة على المصادر الصحفية ذات تواريخ نشر، وتفضّل المقالات الحديثة. بينما تُناسب /api/search/web المحتوى المرجعي العام (وثائق، صفحات بأسلوب ويكيبيديا، صفحات دائمة الخضرة).

04

هل هناك مخطط أداة لوكلاء الذكاء الاصطناعي؟

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