intents
SERP Stack Intent
One query, three independent search indexes: Google, Bing and DuckDuckGo organic results in a single paid call. Use it when a single index is not enough evidence for a grounded answer.
GET/api/public/v1/serp-stack
- price
- $0.015
- atomic
- 15000
- free tier
- 3 calls / agent
- chain
- base mainnet
- asset
- USDC
- scheme
- exact
agent brief
Give a query, get Google + Bing + DuckDuckGo organic results in one response.
engine: · results key: results · settlement: USDC / base / exact
use this when you need to
- -Cross-index grounding before answering
- -Detect index disagreement on a claim
- -Broad citation gathering in one call
query parameters
| name | type | required | description |
|---|---|---|---|
| network | base | base-sepolia | no · default "base" | Payment network. base-sepolia returns mock data for testing. |
| q | string | yes | Search query sent to all three engines |
| gl | string | no · default "us" | Country code for results |
| hl | string | no · default "en" | Interface language code |
| num | integer | no · default "10" | Results per engine |
call it — curl
bash
# Free tier — first 3 calls per agent identity, no payment header
curl "https://marketplaceforaiagents.com/api/public/v1/serp-stack?q=AI+agents"
# Sandbox — signed testnet USDC, mock response, no real spend
curl "https://marketplaceforaiagents.com/api/public/v1/serp-stack?q=AI+agents&network=base-sepolia" \
-H "X-PAYMENT: <base64 signed base-sepolia USDC authorization>"
# Production — signed x402 payment header, real data
curl "https://marketplaceforaiagents.com/api/public/v1/serp-stack?q=AI+agents" \
-H "X-PAYMENT: <base64 signed USDC authorization>"call it — typescript + x402-fetch
typescript
import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";
const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY as `0x${string}`);
const fetchWithPayment = wrapFetchWithPayment(fetch, account);
const res = await fetchWithPayment(
"https://marketplaceforaiagents.com/api/public/v1/serp-stack?q=AI+agents"
);
const data = await res.json();
console.log(data.results);response — 200 ok
application/json
{
"intent": "serp-stack",
"chain": [
"google-search",
"bing-search",
"duckduckgo-search"
],
"steps_run": 3,
"results": {
"google-search": {
"note": "Normalized response of /api/public/v1/google-search"
},
"bing-search": {
"note": "Normalized response of /api/public/v1/bing-search"
},
"duckduckgo-search": {
"note": "Normalized response of /api/public/v1/duckduckgo-search"
}
}
}status codes
200data returned, response includes X-PAYMENT-RESPONSE receipt when paid
400missing or invalid required parameters
402free tier exhausted or invalid X-PAYMENT — body contains accepts[] payment requirements
404unknown endpoint slug
429upstream rate limit — retry with backoff
500upstream or settlement error