api.you.com
GET https://api.you.com/v1/search
You.com Search API: real-time web search returning ranked results grouped by section (results.web, results.news), each with url, title and description; web results also carry snippets. Use when an agent needs fresh, citable web data (news, markets, company facts) to ground a decision. Query params: query (required), count 1-100 (default 10), livecrawl (web|news|all; fetches live page contents, charged per result), country, freshness. Paid per call in USDC.
How to buy
This endpoint takes pay-per-call payments over x402. Call it once without paying to see its live price; any x402 client then pays and retries automatically.
curl -i -X GET "https://api.you.com/v1/search"
# HTTP/1.1 402 Payment Required: price, asset and payTo are in the responseRecent checks
| Checked (UTC) | Result | Status | Time | Live price |
|---|---|---|---|---|
| 2026-10-11 12:16 | Valid 402 | 402 | 8047 ms | $0.005 |
| 2026-10-11 08:00 | Valid 402 | 402 | 1205 ms | $0.005 |
| 2026-10-11 03:30 | Valid 402 | 402 | 1117 ms | $0.005 |
| 2026-10-10 23:00 | Valid 402 | 402 | 1506 ms | $0.005 |
| 2026-10-10 17:15 | Valid 402 | 402 | 1067 ms | $0.005 |
Receipts
No test purchases yet. Graded test purchases are next on our list; until then every number here comes from unpaid checks.
What a check proves