Skip to content
onelayer.
All tools

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

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