Web search to Markdown
Search the web and get the top 3 pages back as clean Markdown in one call, ready for an LLM. Built for AI agents and RAG: no API key, account or sign-up.
POST /api/v1/nodes/web-search-markdown
Is this the right node?
- Use it when
- You need to answer a question from current web pages, not just a list of links.
- Not for
- A plain list of search results; the Google web search results node is cheaper per link.
- You get
- The top 3 results, each with title, URL, description and the full page text as Markdown.
- Typical time
- About 18 seconds per call
How it works
Your agent pays for itself
1Needs something
2Finds it on TollNode
3Pays a few cents
4Gets the result
Two ways to use Web search to Markdown
Way 1 · Pay per call (x402)
For AI agents, no sign-up
Your agent sends the request, gets a 402 with the exact price ($0.017 per search (up to 3 pages)), signs a USDC payment on Base and retries. Nothing is collected unless the call succeeds.
add TollNode to Claude Code, Cursor or Codex (once)
npx agentcash add https://tollnode.comor call it directly
npx agentcash@latest fetch https://tollnode.com/api/v1/nodes/web-search-markdown -m POST -b '{"query":"best project management software for small teams"}'Way 2 · Account + API key
For apps and teams
Create a free account, load a balance with USDC on Base, create an API key and call any node. Same prices; each successful call is deducted from your balance.
curl
curl -X POST https://tollnode.com/api/v1/nodes/web-search-markdown \
-H "Authorization: Bearer $TOLLNODE_API_KEY" \
-H "content-type: application/json" \
-d '{"query":"best project management software for small teams"}'Step-by-step, with code in JavaScript and Python: full guide for Web search to Markdown.
Input
| Field | Type | Notes |
|---|---|---|
| query* | string | What to search for, in plain words (single line) |
Example response
{
"results": [
{
"query": "best project management software for small teams",
"markdown": "10 Best Project Management Tools for Client Projects (2026)\n\n![](https://a.storyblok.com/f/99519/16x16/a6ee231119/ai-…",
"metadata": {
"url": "https://www.teamwork.com/blog/best-project-management-tools/",
"title": "10 Best Project Management Tools for Client Projects (2026)",
"openGraph": [
{}
],
"description": "Compare 10 project management tools on features, pricing and fit, and which go beyond tasks to track budgets, utiliza…",
"canonicalUrl": "https://www.teamwork.com/blog/best-project-management-tools/",
"languageCode": "en",
"redirectedUrl": "https://www.teamwork.com/blog/best-project-management-tools/"
},
"searchResult": {
"url": "https://www.teamwork.com/blog/best-project-management-tools/",
"rank": 1,
"title": "10 Best Project Management Tools for Client Projects (2026)",
"resultType": "ORGANIC",
"description": "Jun 26, 2026 — For simple task tracking, personal productivity, and small team coordination, Trello remains hard to b…"
}
}
]
}FAQ
- When should an agent use the Web search to Markdown node?
- You need to answer a question from current web pages, not just a list of links. It is not meant for a plain list of search results; the Google web search results node is cheaper per link. A call usually takes about 18 seconds.
- What does the Web search to Markdown node return?
- Search the web and get the top 3 pages back as clean Markdown in one call, ready for an LLM. Built for AI agents and RAG: no API key, account or sign-up. Each call returns the top 3 results, each with title, URL, description and the full page text as Markdown.
- How much does one call cost?
- $0.017 in USDC on Base per search (up to 3 pages) (one call = up to 3 pages), charged only when it succeeds. No sign-up, subscription or API key.
- What happens if the call fails?
- You are not charged. TollNode checks your signed payment first, runs the node, and only collects the payment if the result is usable. A failed, empty or timed-out call is never settled, so there is nothing to refund.
- How does an AI agent pay?
- With x402. The first request returns HTTP 402 and the exact price. Any x402 wallet signs the USDC payment and retries automatically. In Claude Code or Cursor, run npx agentcash add https://tollnode.com once.
- Can I use an API key instead?
- Yes. Create a free account, add funds in USDC on Base, create an API key and send it as Authorization: Bearer. Each successful call is deducted from your balance at the same price; failed calls cost nothing.