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

nametyperequireddescription
networkbase | base-sepoliano · default "base"Payment network. base-sepolia returns mock data for testing.
qstringyesSearch query sent to all three engines
glstringno · default "us"Country code for results
hlstringno · default "en"Interface language code
numintegerno · 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