Aapipick
واجهة بحث · أخبار

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

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

15 رصيد / استدعاء60 طلب / دقيقةPOST /api/search/news

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

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

API Authentication Required
Enter your API key to access this service. All API calls require authentication.

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

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

تسجيل الدخولإدارة مفاتيح API
5 استعلامات نموذجية — انقر للتحميل

API Integration Guide

Learn how to integrate this API into your applications with code examples and detailed documentation.

API Overview
بحث إخباري فوري مع مرشحات نطاق التاريخ والبلد. تُعيد عناوين مرتّبة مع مقتطفات نظيفة جاهزة لـ LLM في المرحلة التالية.
POST
/api/search/news

Base URL

https://www.apipick.com

Full Endpoint

https://www.apipick.com/api/search/news
Parameters
Required and optional parameters for this API
query
required
string

Natural-language search query

max_num_results
optional
integer

1–5, default 5

relevance_threshold
optional
number

0.0–1.0 quality filter

country_code
optional
string

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

start_date
optional
string

ISO date YYYY-MM-DD

end_date
optional
string

ISO date YYYY-MM-DD

Code Examples
Copy and paste these examples to quickly integrate the API into your application

cURL Request

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"
}'
Replace YOUR_API_KEY with your actual API key
Response Example
Example response from the API

JSON 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
}
Integration Tips

✓Best Practices

  • • Always include x-api-key header
  • • Always handle errors gracefully
  • • Validate input data before sending
  • • Use HTTPS for secure communication
  • • Cache responses when appropriate

ℹResponse Headers

  • • Content-Type: application/json
  • • x-api-key: Required for authentication
  • • Status codes: 200 (success), 400 (error), 401 (unauthorized)
  • • No rate limiting applied

Rate Limits

⏱️

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
}

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

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

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

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

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

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

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

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

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