POST
$0.01 default
/searchDescription
Web search built for agents: ranked results with title, URL, snippet and relevance score, optionally a generated answer, images, and the raw page content per result. Filter by topic (general, news, finance), by date range, or to a domain list.
Pricing
$0.01 default
Request schema
{
"properties": {
"end_date": {
"description": "Only results published on or before this date (YYYY-MM-DD).",
"example": "2026-05-28",
"format": "date",
"type": "string"
},
"exclude_domains": {
"description": "Drop results from these domains.",
"example": [
"example.com"
],
"items": {
"type": "string"
},
"type": "array"
},
"include_answer": {
"default": false,
"description": "Return a generated answer alongside the results.",
"type": "boolean"
},
"include_domains": {
"description": "Restrict the search to these domains.",
"example": [
"x402.org",
"docs.cdp.coinbase.com"
],
"items": {
"type": "string"
},
"type": "array"
},
"include_images": {
"default": false,
"description": "Return image results.",
"type": "boolean"
},
"include_raw_content": {
"default": false,
"description": "Return the raw page content per result.",
"type": "boolean"
},
"max_results": {
"description": "Number of results: \"auto\", or an integer between 1 and 50.",
"example": 5,
"oneOf": [
{
"const": "auto"
},
{
"maximum": 50,
"minimum": 1,
"type": "integer"
}
]
},
"query": {
"description": "The search query.",
"example": "what is x402?",
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"search_depth": {
"default": "advanced",
"description": "The only tier the x402 gateway prices, and the one this price covers.",
"enum": [
"advanced"
],
"type": "string"
},
"start_date": {
"description": "Only results published on or after this date (YYYY-MM-DD).",
"example": "2026-01-01",
"format": "date",
"type": "string"
},
"time_range": {
"description": "Relative recency window, e.g. day, week, month, year.",
"example": "month",
"type": "string"
},
"topic": {
"default": "general",
"description": "Which index to search.",
"enum": [
"general",
"news",
"finance"
],
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}Response schema
{
"properties": {
"answer": {
"description": "Present when include_answer is true.",
"type": [
"string",
"null"
]
},
"images": {
"items": {
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"request_id": {
"type": "string"
},
"response_time": {
"type": "number"
},
"results": {
"items": {
"properties": {
"content": {
"type": "string"
},
"raw_content": {
"type": [
"string",
"null"
]
},
"score": {
"type": "number"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}Example request
{
"include_answer": true,
"max_results": 5,
"query": "what is x402?",
"topic": "general"
}Example response
{
"answer": null,
"images": [],
"query": "what is x402?",
"request_id": "8146b0d8-db42-42a7-8fb9-3796fce6853e",
"response_time": 0.7,
"results": [
{
"content": "x402 is an open payment protocol that revives the HTTP 402 status code so AI agents can pay per request in stablecoins, with no API keys or accounts.",
"raw_content": null,
"score": 0.92,
"title": "x402 — Payment Required",
"url": "https://x402.org/"
}
]
}