Skip to content
onelayer.
All tools

Tool detail

Web Search

Runs a general web search via the Tavily API and returns ranked results (title, URL, snippet, relevance score) with an optional synthesized answer.

Categories: Web scraping

Use when

  • search the web for current information on a topic
  • get ranked web results restricted to specific domains

Not for

  • not full page content, title/url/snippet only
  • not a news-specific or crypto-specific search

Inputs

GET query params: q (string 1-400 chars, required); optional depth (basic/advanced), max (1-10, default 5), include_domains, exclude_domains.

Admitted input schema

{
  "type": "object",
  "properties": {
    "depth": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "enum": [
        "basic",
        "advanced"
      ],
      "description": "Search depth. \"advanced\" costs Tavily more upstream but is not priced differently to the buyer yet. Default: basic.",
      "default": "basic",
      "examples": [
        "basic",
        "advanced"
      ]
    },
    "exclude_domains": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional comma-separated domains to exclude from results.",
      "examples": [
        "pinterest.com"
      ]
    },
    "include_domains": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Optional comma-separated domains to restrict results to, e.g. wikipedia.org,bbc.com.",
      "examples": [
        "wikipedia.org",
        "nytimes.com,bbc.com"
      ]
    },
    "max": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "pattern": "^\\d{1,2}$",
      "description": "Maximum number of results to return. Integer 1-10. Default: 5.",
      "default": "5",
      "examples": [
        "5",
        "10"
      ]
    },
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 400,
      "description": "Search query. Required, 1-400 characters.",
      "examples": [
        "who is Leo Messi",
        "latest news on EU AI Act enforcement"
      ]
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://4yearcycle.com/x402/web-search

Payment

Protocol
x402
Listed price
0.01 USDC per call on Base
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://4yearcycle.com/x402/web-search
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z