79trust / 100

Search

by api.you.com in Search & web

x402 APIPassing, checked 57 min ago

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

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
847 ms typical, 847 ms slowest 5%
Last check
57 min ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X GET "https://api.you.com/v1/search?count=10&query=NVDA+earnings+guidance+Q2+2026"
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.you.com%2Fv1%2Fsearch
const res = await pay("https://api.you.com/v1/search?count=10&query=NVDA+earnings+guidance+Q2+2026");
console.log(await res.json());

Example input

{
  "count": 10,
  "query": "NVDA earnings guidance Q2 2026"
}

Example output

{
  "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"
      }
    ]
  }
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
57 min agoPassed4021.6 s$0.005
4 h agoPassed402847 ms$0.005
9 h agoPassed402787 ms$0.005