api.you.com
You.com Search API: real-time web search returning ranked results grouped by section (results.web, results.news), each with url, title and description; web results also carry snippets. Use when an agent needs fresh, citable web data (news, markets, company facts) to ground a decision. Query params: query (required), count 1-100 (default 10), livecrawl (web|news|all; fetches live page contents, charged per result), country, freshness. Paid per call in USDC.
Offering
- Provider
- api.you.com
- Method
- GET
- Offering type
- Api Endpoint
- Transport type
- http
- Category
- Web Search Research
- Delivery
- Not provided
- Pricing model
- Not provided
- x402 version
- 2
Endpoint context
- URL
https://api.you.com/v1/search- MIME type
- application/json
- First seen
- 2026-10-16T01:50:06.715Z
- Last seen
- Tags
- X402, web-search, finance-research
Payment pricing
x402 payment terms are the authoritative price for calling this endpoint.
- Payment option 1
- 0.005 USDC
Atomic price: 5000 · Network: eip155:8453 · Asset: USDC · Scheme: exact - Payment option 2
- 0.005 USDC
Atomic price: 5000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
{
"scheme": "exact",
"network": "eip155:8453",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000",
"payTo": "0xc327D0aEb5f65B514b193b5e5A95cC6F4060815f"
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "5000",
"payTo": "GBQ2FrH49gvKXu1zg7tguoLwaofn5S4NnuMs5JSYQ5GX"
}
]Observed health
- Status
- Healthy
- Latest latency
- 1798 ms
- Average latency
- 1561 ms
- HTTP status
- 402
- Last checked
- Reachability
- 92.9% over 14 checks
Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.
Input schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"type": "string",
"enum": [
"GET",
"HEAD",
"DELETE"
]
},
"queryParams": {
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 40000,
"description": "The web search query."
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 10,
"description": "Number of results to return, capped at 100. Also sets the number of pages charged for when livecrawl is enabled."
},
"livecrawl": {
"type": "string",
"enum": [
"web",
"news",
"all"
],
"description": "Fetch live page contents for the results instead of serving index snippets alone. Priced per result on top of the base call price, so the quoted amount scales with count. Omit for the base price."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code for geographic focus."
},
"freshness": {
"type": "string",
"description": "Recency filter: day | week | month | year, or a date range 'YYYY-MM-DDtoYYYY-MM-DD'."
}
},
"required": [
"query"
]
}
},
"required": [
"type",
"method"
],
"additionalProperties": false
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET",
"HEAD",
"DELETE"
],
"type": "string"
},
"queryParams": {
"properties": {
"count": {
"default": 10,
"description": "Number of results to return, capped at 100. Also sets the number of pages charged for when livecrawl is enabled.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"country": {
"description": "ISO 3166-1 alpha-2 country code for geographic focus.",
"type": "string"
},
"freshness": {
"description": "Recency filter: day | week | month | year, or a date range 'YYYY-MM-DDtoYYYY-MM-DD'.",
"type": "string"
},
"livecrawl": {
"description": "Fetch live page contents for the results instead of serving index snippets alone. Priced per result on top of the base call price, so the quoted amount scales with count. Omit for the base price.",
"enum": [
"web",
"news",
"all"
],
"type": "string"
},
"query": {
"description": "The web search query.",
"maxLength": 40000,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"metadata": {
"properties": {
"latency": {
"description": "Server-side latency in seconds.",
"type": "number"
},
"query": {
"description": "The query as searched.",
"type": "string"
},
"search_uuid": {
"description": "Request identifier, useful when reporting issues.",
"type": "string"
}
},
"required": [
"query",
"search_uuid",
"latency"
],
"type": "object"
},
"results": {
"additionalProperties": {
"type": "array"
},
"description": "Page results keyed by section: 'web' and 'news'. A section is omitted when it returned no results, so do not assume any key is present; an all-empty response is '{}'.",
"properties": {
"news": {
"items": {
"properties": {
"contents": {
"description": "Scraped page contents, keyed by requested format (default 'html'). Present only when livecrawl was requested and the fetch succeeded.",
"type": "object"
},
"description": {
"type": "string"
},
"favicon_url": {
"type": "string"
},
"original_thumbnail_url": {
"type": "string"
},
"page_age": {
"description": "Publication timestamp, when the source exposes one. Naive ISO-8601 ('2026-08-01T14:02:00') — no timezone offset and no trailing 'Z'.",
"type": "string"
},
"snippets": {
"description": "Index snippets matching the query. Emitted on 'web' results; 'news' results carry 'description' instead and have no snippets.",
"items": {
"type": "string"
},
"type": "array"
},
"source_name": {
"type": "string"
},
"thumbnail_url": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Result URL.",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"type": "array"
},
"web": {
"items": {
"properties": {
"contents": {
"description": "Scraped page contents, keyed by requested format (default 'html'). Present only when livecrawl was requested and the fetch succeeded.",
"type": "object"
},
"description": {
"type": "string"
},
"favicon_url": {
"type": "string"
},
"original_thumbnail_url": {
"type": "string"
},
"page_age": {
"description": "Publication timestamp, when the source exposes one. Naive ISO-8601 ('2026-08-01T14:02:00') — no timezone offset and no trailing 'Z'.",
"type": "string"
},
"snippets": {
"description": "Index snippets matching the query. Emitted on 'web' results; 'news' results carry 'description' instead and have no snippets.",
"items": {
"type": "string"
},
"type": "array"
},
"source_name": {
"type": "string"
},
"thumbnail_url": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Result URL.",
"type": "string"
}
},
"required": [
"url"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
"required": [
"results",
"metadata"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}