← Market

Search

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.

GET https://api.you.com/v1/search

0.005 USDC on Base · payTo 0xc327D0aEb5f65B514b193b5e5A95cC6F4060815f

Status: verified · payable

Operator badge: embed this endpoint's live status badge — it reads "Verified Payable" only while the probe record backs it.

Settlement: direct to the seller's payTo — 0% HIVE402 take

Payment routes

Base · 0.005 USDC · payTo 0xc327D0aEb5f65B514b193b5e5A95cC6F4060815f · via cdp · settles direct
Solana · 0.005 USDC · payTo GBQ2FrH49gvKXu1zg7tguoLwaofn5S4NnuMs5JSYQ5GX · via cdp · settles direct
{
  "count": 10,
  "query": "NVDA earnings guidance Q2 2026"
}
{
  "metadata": {
    "latency": 0.42,
    "query": "NVDA earnings guidance Q2 2026",
    "search_uuid": "0a1d1f6e-6a1a-4a6e-9a9a-5f4f2b7d3c11"
  },
  "results": {
    "news": [
      {
        "description": "Management guided next quarter above consensus.",
        "page_age": "2026-08-01T14:02:00",
        "thumbnail_url": "https://example.com/thumb/nvda-call.jpg",
        "title": "NVIDIA earnings call: guidance above consensus",
        "url": "https://example.com/nvda-earnings-call"
      }
    ],
    "web": [
      {
        "description": "NVIDIA lifted its outlook on data-center demand.",
        "favicon_url": "https://example.com/favicon.ico",
        "page_age": "2026-08-01T14:02:00",
        "snippets": [
          "NVIDIA expects revenue of ... driven by data-center GPU demand."
        ],
        "thumbnail_url": "https://example.com/thumb/nvda-guidance.jpg",
        "title": "NVIDIA raises Q2 revenue guidance",
        "url": "https://example.com/nvda-guidance"
      }
    ]
  }
}

Script Master Labs LLC · SDVOSB · Kinston, NC · Terms · Refunds · Privacy · Contact

SML network: ScriptMasterLabs — the main site · SML Dual Market — the human storefront · VA Ratings — VA disability ratings, free for veterans

Agent intel trust badge

Trust score72 / 100 · breakdown
Probe uptime (30d)100.0% over 1 probes · daily
Avg 402 latency139 ms
Paid calls (30d, on-chain)7 calls · 5 buyers
Facilitator-reported (30d)348 calls · 16 payers (CDP Bazaar)

How to call

GET https://api.you.com/v1/search · input in query · spec from live-challenge

Input schema
{
  "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"
  ]
}
Output schema
{
  "type": "object",
  "properties": {
    "results": {
      "type": "object",
      "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": {
        "web": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "description": "Result URL."
              },
              "title": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "snippets": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Index snippets matching the query. Emitted on 'web' results; 'news' results carry 'description' instead and have no snippets."
              },
              "page_age": {
                "type": "string",
                "description": "Publication timestamp, when the source exposes one. Naive ISO-8601 ('2026-08-01T14:02:00') — no timezone offset and no trailing 'Z'."
              },
              "favicon_url": {
                "type": "string"
              },
              "thumbnail_url": {
                "type": "string"
              },
              "original_thumbnail_url": {
                "type": "string"
              },
              "source_name": {
                "type": "string"
              },
              "contents": {
                "type": "object",
                "description": "Scraped page contents, keyed by requested format (default 'html'). Present only when livecrawl was requested and the fetch succeeded."
              }
            },
            "required": [
              "url"
            ]
          }
        },
        "news": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "url": {
                "type": "string",
                "description": "Result URL."
              },
              "title": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "snippets": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Index snippets matching the query. Emitted on 'web' results; 'news' results carry 'description' instead and have no snippets."
              },
              "page_age": {
                "type": "string",
                "description": "Publication timestamp, when the source exposes one. Naive ISO-8601 ('2026-08-01T14:02:00') — no timezone offset and no trailing 'Z'."
              },
              "favicon_url": {
                "type": "string"
              },
              "thumbnail_url": {
                "type": "string"
              },
              "original_thumbnail_url": {
                "type": "string"
              },
              "source_name": {
                "type": "string"
              },
              "contents": {
                "type": "object",
                "description": "Scraped page contents, keyed by requested format (default 'html'). Present only when livecrawl was requested and the fetch succeeded."
              }
            },
            "required": [
              "url"
            ]
          }
        }
      },
      "additionalProperties": {
        "type": "array"
      }
    },
    "metadata": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "The query as searched."
        },
        "search_uuid": {
          "type": "string",
          "description": "Request identifier, useful when reporting issues."
        },
        "latency": {
          "type": "number",
          "description": "Server-side latency in seconds."
        }
      },
      "required": [
        "query",
        "search_uuid",
        "latency"
      ]
    }
  },
  "required": [
    "results",
    "metadata"
  ]
}
curl -i -X GET 'https://api.you.com/v1/search?query=NVDA+earnings+guidance+Q2+2026&count=10'

Agents: POST https://hive402.scriptmasterlabs.com/mcp → route_task / proxy_call · SDK /sdk/hive402.mjs

Try it (your wallet signs; HIVE402 never holds funds)