Search, then page text
Runs a live web search and extracts the top 3 results by default (up to 5 if you ask). Each hit comes back with title, URL, snippet, score, domain and the page markdown.
New · native x402 on Base · $0.015 per call
Search and read in one paid call
One request searches the live web and returns the top pages as clean, LLM-ready markdown. $0.015 instead of $0.029 a la carte (one search plus three extracts), and one payment instead of four. Charged only when at least one page has text. No account, plan or API key.
POST https://api.agentsearchhq.com/x402/v1/search_and_read
What it does
Agents usually search, then read the top hits. Doing that as separate calls costs $0.008 + 3 × $0.007 = $0.029 and four x402 payments. Search + Read does it in one call.
$0.015, not $0.029
15,000 atomic USDC on Base, paid to AgentSearch. That is 48% less than the a la carte path, and a single PAYMENT-SIGNATURE instead of four.
Only when a page has text
If the search returns nothing, or every page extract comes back empty or failed, you are not charged. Invalid input (400) and upstream failures (502) are also free.
Request and response
JSON in, JSON out. Full machine-readable schema: search-and-read OpenAPI and the live api.agentsearchhq.com/openapi.json.
| Field | Default | Notes |
|---|---|---|
query | required | Natural language or keywords, 1–400 characters. |
num_results | 3 | How many top results to read, 1–5. max_results is an alias if num_results is omitted. |
max_chars | 8000 | Maximum markdown characters per page, 1–20000. |
render_fallback | false | If true, retry at most one empty or thin page in a headless browser. |
The 200 body has query, result_count, extracted_count, retrieved_at and a results array. Each result includes markdown, chars, truncated, extract_status (ok, empty, failed, timeout, blocked, rendered) and source.
See the price without paying (curl)
An unpaid request is free and returns HTTP 402 with the terms. Paying needs an x402 client; examples are on the direct x402 docs.
Unpaid request (nothing charged)
curl -si https://api.agentsearchhq.com/x402/v1/search_and_read \
-H 'content-type: application/json' \
-d '{"query":"x402 payment protocol","num_results":3}' | head -20
# Decode the 402 terms (amount 15000 = $0.015, network eip155:8453, USDC)
curl -s -D - -o /dev/null https://api.agentsearchhq.com/x402/v1/search_and_read \
-H 'content-type: application/json' -d '{"query":"x402"}' \
| grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 -d | python3 -m json.toolBody and typical 200 shape
// POST https://api.agentsearchhq.com/x402/v1/search_and_read
{"query": "x402 payment protocol", "num_results": 3, "max_chars": 8000}
// 200, only after payment settles on a non-empty extract:
{
"query": "x402 payment protocol",
"result_count": 3,
"extracted_count": 2,
"results": [
{
"title": "...", "url": "https://...", "snippet": "...",
"markdown": "# ...", "chars": 4120, "truncated": false,
"extract_status": "ok", "source": "extract"
}
]
}When to use it
You need hits and their text
Research, RAG grounding, or any agent that would search and then extract the top pages. One payment, one round trip, $0.015.
Search only, or you already have URLs
Free or $0.008 search if you just need links. $0.007 extract or $0.010 render if you already have a URL. The usual free-search-then-extract loop still works and is cheaper when you only read one page.
Direct API only
Search + Read is sold only at api.agentsearchhq.com. The Pocket Network route still has Search, Extract and Render at $0.005 each. There is no free tier for this combined call.
Docs and related tools
Direct x402 docs: Search + Read · Pricing · OpenAPI · Changelog note · short link: agentsearchhq.com/sar
Web Search
Search only
Ranked live results, $0.008, or free up to 25/day per IP.
Web Extract
Read a URL you already have
One page to markdown for $0.007.