Documentation
POST /v1/search
coverage="official" means the query carried official intent AND the rank-1 result is a trusted domain (*.gov.*, *.edu.*, *.ac.*, Wikipedia, licensed banks, the official-entity allowlist) — measured 12/13 on the official set. coverage="best-effort" is an honest general-web answer.
Search the web. Official-intent queries promote a trusted domain to rank 1 and answer coverage="official"; everything else is honestly "best-effort".
Request
| Field | Type | Description | |
|---|---|---|---|
query | string | required | The search query (any language; Arabic handled natively). |
k | integer | optional | Number of results (1–20, default 10). |
mode | 'default' | 'deep-read' | optional | deep-read opens top pages for evidence-based ranking; default is snippet ranking. |
lang | string | optional | Language hint for engine routing. |
Example
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());
Response
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
}Errors
| Status | code | Example |
|---|---|---|
| 400 | bad_request | {"code":"bad_request","message":"query is required"} |
| 502 | fetch_failed | {"code":"fetch_failed","message":"all search routes failed"} |