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

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

نقطة نهاية بحث ويب فورية مبنية لاستدعاء أدوات LLM. مخرجات JSON قابلة للتنبؤ، تصفية بلد وتاريخ، وفوترة الأرصدة لكل استدعاء — يمكن إدخالها في OpenAI function calling أو tool use في Claude أو أي إطار عمل وكلاء.

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

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

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/web" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "latest developments in quantum computing",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "latest developments in quantum computing",
  "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 ]

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

ما الفرق عن واجهات Google أو Bing للبحث؟

الاستجابات مهيّأة مسبقًا لاستهلاك LLM: مقتطفات قصيرة (بلا قوالب جاهزة)، JSON منظّم، ودرجة صلة. لا حاجة إلى خطوة منفصلة للزحف والتنظيف قبل تمرير النتائج إلى النموذج.

كيف تُرتَّب النتائج؟

تُرتَّب النتائج عبر تضمينات دلالية بدلًا من مطابقة الكلمات المفتاحية، فتظل المعاني المتشابهة قريبة حتى لو اختلفت الصياغة. يمكنك أيضًا تمرير relevance_threshold (0.0–1.0) لإسقاط النتائج منخفضة الجودة.

هل يمكنني التقييد ببلد أو نطاق تاريخ معيّن؟

نعم. مرّر country_code (ISO 3166-1 alpha-2 مثل US أو JP) و/أو start_date / end_date بصيغة YYYY-MM-DD.

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

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

هل هناك مخطط أداة لـ OpenAI function calling؟

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