Tool detail
search
Runs a real-time web search and returns ranked results grouped by web and news, each with URL, title, description and snippets.
Categories: Web search
Use when
- find fresh, citable web results for a query
- search recent news on a topic
- ground an answer in current web sources with URLs to cite
Not for
- fetching full page text for every result — use livecrawl or a page reader
- one synthesized answer instead of a ranked list — use an Answer/Research API
Inputs
GET query params: query (string, required); count (1-100, default 10), country, freshness, livecrawl (web|news|all) — all optional
Admitted input schema
{
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Number of results to return, capped at 100. Also sets the number of pages charged for when livecrawl is enabled.",
"default": 10
},
"country": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"description": "ISO 3166-1 alpha-2 country code for geographic focus."
},
"freshness": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"description": "Recency filter: day | week | month | year, or a date range 'YYYY-MM-DDtoYYYY-MM-DD'."
},
"livecrawl": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"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."
},
"query": {
"type": "string",
"minLength": 0,
"maxLength": 4096,
"description": "The web search query."
}
},
"required": [
"query"
],
"additionalProperties": false
}Endpoint
- Method
GET- URL
https://api.you.com/v1/search
Payment
- Protocol
- x402
- Listed price
- 0.005 USDC per call on Base (livecrawl scales the price with count)
- Payment method
- exact
- Network
- eip155:8453
- Asset
- 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.
Source
- Directory
- Coinbase x402 Bazaar
- Record
- GET https://api.you.com/v1/search
- Retrieved
- 2026-09-30T20:37:07.382Z
- Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524- Catalog built
- 2026-09-30T22:31:58.034Z