🧭Find an API (Directory Search)
Describe what you need and get back matching x402-paid APIs: our own catalog (54 tools) plus, optionally, the live x402 Bazaar of third-party sellers. The agent's meta-tool — instead of knowing an API exists, ask for the capability.
🔌 Server-side tool
This tool runs on the server (it fetches third-party URLs directly and cannot run in your browser). Use the paid JSON API below — the worked examples show real server-side results and refresh automatically.
Worked examples
Need PDF text extraction
GET /api/v1/dev/directory-search?query=convert%20pdf%20to%20text&includeBazaar=true&limit=5
Result: 5 matching APIs (5 ours · 0 Bazaar)
Weather capability
GET /api/v1/dev/directory-search?query=weather%20forecast&includeBazaar=false
Result: 1 matching API (1 ours · 0 Bazaar)
Wallet analysis
GET /api/v1/dev/directory-search?query=wallet%20analysis%20crypto&includeBazaar=true&limit=6
Result: 6 matching APIs (6 ours · 0 Bazaar)
Machine API (x402)
$0.002 / callThis tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol — no accounts, no API keys.
GET /api/v1/dev/directory-search?query=convert%20pdf%20to%20text&includeBazaar=true&limit=5 HTTP/1.1
Host: agenttools-hub.vercel.app
→ 402 (payment required, instructions in headers)
→ 200 (after X-PAYMENT header; JSON body below)
{
"tool": "dev/directory-search",
"input": {"query":"convert pdf to text","includeBazaar":"true","limit":5},
"result": { "value": 5, "answer": "5 matching APIs (5 ours · 0 Bazaar)" }
}Agent docs: /llms.txt · OpenAPI spec · integration guide
About this tool
The meta-tool: instead of knowing an API exists, describe the capability you need — 'convert pdf to text', 'wallet analysis' — and get back matching paid APIs with prices. Searches our catalog and the live x402 Bazaar where other sellers' tools are indexed. Agents spend $0.002 to avoid building the wrong thing.
Frequently asked questions
Which sources are searched?
Always our own catalog (all tools, scored by keyword relevance to your intent). Optionally the live x402 Bazaar — the facilitator-hosted index of other sellers' paid endpoints.
Why is this useful when I could search the web?
Web search returns marketing pages. This returns directly callable x402 endpoints with exact per-call prices — the difference between research and action.