Web Search
GET 4yearcycle.com/x402/web-search
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
General web search reselling the Tavily Search API: query the live web and get back ranked results (title, URL, snippet, relevance score) plus an optional short synthesized answer, with basic or advanced search depth and optional domain include/exclude filters.
Resource: 4yearcycle.com/x402/web-search
Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x9862ca83b72aB95521F457aFf6e6EFb03d8164C3
Payment methods: — · Last validation: 2026-09-14 16:41:58.263+00
{
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"examples": [
"who is Leo Messi",
"latest news on EU AI Act enforcement"
],
"maxLength": 400,
"minLength": 1,
"description": "Search query. Required, 1-400 characters."
},
"max": {
"type": "string",
"default": "5",
"pattern": "^\\d{1,2}$",
"examples": [
"5",
"10"
],
"description": "Maximum number of results to return. Integer 1-10. Default: 5."
},
"depth": {
"enum": [
"basic",
"advanced"
],
"type": "string",
"default": "basic",
"examples": [
"basic",
"advanced"
],
"description": "Search depth. \"advanced\" costs Tavily more upstream but is not priced differently to the buyer yet. Default: basic."
},
"exclude_domains": {
"type": "string",
"examples": [
"pinterest.com"
],
"description": "Optional comma-separated domains to exclude from results."
},
"include_domains": {
"type": "string",
"examples": [
"wikipedia.org",
"nytimes.com,bbc.com"
],
"description": "Optional comma-separated domains to restrict results to, e.g. wikipedia.org,bbc.com."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"query",
"count",
"results"
],
"properties": {
"count": {
"type": "integer",
"description": "Number of results returned"
},
"query": {
"type": "string",
"description": "Query as sent to Tavily"
},
"answer": {
"type": [
"string",
"null"
],
"description": "Tavily's short synthesized answer, null if unavailable"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url",
"snippet",
"score"
],
"properties": {
"url": {
"type": "string",
"description": "Source URL"
},
"score": {
"type": "number",
"description": "Tavily relevance score for this result (higher = more relevant)"
},
"title": {
"type": "string",
"description": "Page title as indexed by Tavily"
},
"snippet": {
"type": "string",
"description": "Tavily's extracted content for this result, capped to 500 characters"
}
}
},
"description": "Ranked search results, most relevant first"
},
"responseTimeMs": {
"type": "integer",
"description": "Upstream Tavily response time in milliseconds"
}
}
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9862ca83b72aB95521F457aFf6e6EFb03d8164C3",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0x9862ca83b72aB95521F457aFf6e6EFb03d8164C3",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "10000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.