التوثيق
POST /v1/search
coverage="official" تعني أن الاستعلام حمل قصدًا رسميًا وأن نتيجة المركز الأول دومين موثوق (*.gov.* · *.edu.* · *.ac.* · ويكيبيديا · بنوك مرخّصة · قايمة الجهات الرسمية) — مقيسة 12/13 على المجموعة الرسمية. و"best-effort" إجابة ويب عامة صادقة.
يبحث على الويب. استعلامات القصد الرسمي ترفع دومينًا موثوقًا للمركز الأول وترد coverage="official"؛ وسوى ذلك يرد بصراحة "best-effort".
الطلب
| الحقل | النوع | الوصف | |
|---|---|---|---|
query | string | مطلوب | نص البحث (أي لغة؛ العربية مدعومة أصيلة). |
k | integer | اختياري | عدد النتائج (1–20، الافتراضي 10). |
mode | 'default' | 'deep-read' | اختياري | deep-read يفتح الصفحات الأولى للترتيب بالدليل؛ الافتراضي ترتيب بالمقتطفات. |
lang | string | اختياري | تلميح لغوي لتوجيه المحركات. |
مثال
curl -X POST https://agw.orcanox.xyz/v1/search \ -H "Authorization: Bearer agw_…" \ -H "Content-Type: application/json" \ -d '{"query":"أحدث أسعار البنزين في السعودية"}'
import requests r = requests.post("https://agw.orcanox.xyz/v1/search", headers={"Authorization": "Bearer agw_…"}, json={"query":"أحدث أسعار البنزين في السعودية"}) print(r.status_code, r.json())
const r = await fetch("https://agw.orcanox.xyz/v1/search", { method: "POST", headers: { "Authorization": "Bearer agw_…", "Content-Type": "application/json" }, body: JSON.stringify({"query":"أحدث أسعار البنزين في السعودية"}) }); console.log(r.status, await r.json());
الاستجابة
json
{
"query": "هيئة الغذاء والدواء السعودية",
"items": [
{
"url": "https://www.sfda.gov.sa/…",
"title": "Saudi Food and Drug Authority",
"snippet": "The Saudi Food and Drug Authority (SFDA) is…",
"score": 0.81
}
],
"routeAttempts": [
{
"route": "searxng",
"status": "ok",
"ms": 640
}
],
"coverage": "official",
"tookMs": 1210
}الأخطاء
| الحالة | code | مثال |
|---|---|---|
| 400 | bad_request | {"code":"bad_request","message":"query is required"} |
| 502 | fetch_failed | {"code":"fetch_failed","message":"all search routes failed"} |