Api reference
Search
High-authority web search with fixed per-call billing
Endpoint
POST /v1/searchRequest Headers
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | API key in Bearer token format: Bearer sk-ar-... |
x-api-key | string | No | Alternative authentication method |
Content-Type | string | Yes | application/json |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search keywords |
n | integer | No | Number of results, default 10, range 1-20 |
category | string | No | Scenario hint: programming, research, gov, business |
Response
{
"query": "北京 天气",
"n": 1,
"results": [
{
"title": "...",
"url": "...",
"snippet": "...",
"source": "..."
}
]
}Upstream errors are forwarded with the upstream status code when possible.
Billing
- Fixed price: $0.01 USD per request (billed after a successful upstream 2xx response).
- Returns
402 Payment Requiredwhen wallet balance is insufficient.