Market Data · x402

You.com Search API: real-time web search returning ranked results grouped by section (r…

by api-staging.you.com · discovered, not yet claimed by its owner · updated 2026-08-28

Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.

What it does

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.

Tags: bazaar

Use with an agent

Discover. Agents find this listing with GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP tool search_resources, or /discovery/resources.
Inspect. Fetch /resources/13322.json for the price and payment options.
Pay. Call GET https://api-staging.you.com/v1/search. The provider answers 402 with its payment requirements. An x402 client signs one of the options below and retries with PAYMENT-SIGNATURE.
Execute. The provider returns 200 with the data. Agent Bazaar is not in the request path and never sees your payment.

For humans

You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base Sepolia, Solana Devnet, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.

Pricing & payment

Price: see accepts
Protocol: x402 v2
Auth: No account or API key. Pay per request.
Networks: Base Sepolia, Solana Devnet
Calls (30d): 2 · 1 unique payers (third-party data from the public x402 Bazaar)

x402 payment requirements

Scheme	Network	Asset	Amount	Pay to	Timeout
exact	Base Sepolia eip155:84532	USDC	5000	0x55aA118529184e3603F9d1043eBD35C87c7C4721	600s
exact	Solana Devnet solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1	4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU	5000	AceNQWvT8CxpSN1FNH5ft4fhSAYBgY7wiTu3nDLz6LzQ	600s

accepts[] (raw JSON)

[
  {
    "scheme": "exact",
    "network": "eip155:84532",
    "payTo": "0x55aA118529184e3603F9d1043eBD35C87c7C4721",
    "asset": "0x036CbD53842c5426634e7929541eC2318f3dCF7e",
    "amount": "5000",
    "maxTimeoutSeconds": 600
  },
  {
    "scheme": "exact",
    "network": "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1",
    "payTo": "AceNQWvT8CxpSN1FNH5ft4fhSAYBgY7wiTu3nDLz6LzQ",
    "asset": "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU",
    "amount": "5000",
    "maxTimeoutSeconds": 600
  }
]

Schemas

Output schema (JSON Schema)

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {
          "count": 10,
          "query": "NVDA earnings guidance Q2 2026"
        },
        "type": "http"
      },
      "output": {
        "example": {
          "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"
              }
            ]
          }
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET",
                "HEAD",
                "DELETE"
              ],
              "type": "string"
            },
            "queryParams": {
              "properties": {
                "count": {
                  "default": 10,
                  "description": "Number of results to return, capped at 100. Also sets the number of pages charged for when livecrawl is enabled.",
                  "maximum": 100,
                  "minimum": 1,
                  "type": "integer"
                },
                "country": {
                  "description": "ISO 3166-1 alpha-2 country code for geographic focus.",
                  "type": "string"
                },
                "freshness": {
                  "description": "Recency filter: day | week | month | year, or a date range 'YYYY-MM-DDtoYYYY-MM-DD'.",
                  "type": "string"
                },
                "livecrawl": {
                  "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.",
                  "enum": [
                    "web",
                    "news",
                    "all"
                  ],
                  "type": "string"
                },
                "query": {
                  "description": "The web search query.",
                  "maxLength": 40000,
                  "type": "string"
                }
              },
              "required": [
                "query"
              ],
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "properties": {
                "metadata": {
                  "properties": {
                    "latency": {
                      "description": "Server-side latency in seconds.",
                      "type": "number"
                    },
                    "query": {
                      "description": "The query as searched.",
                      "type": "string"
                    },
                    "search_uuid": {
                      "description": "Request identifier, useful when reporting issues.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "query",
                    "search_uuid",
                    "latency"
                  ],
                  "type": "object"
                },
                "results": {
                  "additionalProperties": {
                    "type": "array"
                  },
                  "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": {
                    "news": {
                      "items": {
                        "properties": {
                          "contents": {
                            "description": "Scraped page contents, keyed by requested format (default 'html'). Present only when livecrawl was requested and the fetch succeeded.",
                            "type": "object"
                          },
                          "description": {
                            "type": "string"
                          },
                          "favicon_url": {
                            "type": "string"
                          },
                          "original_thumbnail_url": {
                            "type": "string"
                          },
                          "page_age": {
                            "description": "Publication timestamp, when the source exposes one. Naive ISO-8601 ('2026-08-01T14:02:00') — no timezone offset and no trailing 'Z'.",
                            "type": "string"
                          },
                          "snippets": {
                            "description": "Index snippets matching the query. Emitted on 'web' results; 'news' results carry 'description' instead and have no snippets.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "source_name": {
                            "type": "string"
                          },
                          "thumbnail_url": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "url": {
                            "description": "Result URL.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "url"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "web": {
                      "items": {
                        "properties": {
                          "contents": {
                            "description": "Scraped page contents, keyed by requested format (default 'html'). Present only when livecrawl was requested and the fetch succeeded.",
                            "type": "object"
                          },
                          "description": {
                            "type": "string"
                          },
                          "favicon_url": {
                            "type": "string"
                          },
                          "original_thumbnail_url": {
                            "type": "string"
                          },
                          "page_age": {
                            "description": "Publication timestamp, when the source exposes one. Naive ISO-8601 ('2026-08-01T14:02:00') — no timezone offset and no trailing 'Z'.",
                            "type": "string"
                          },
                          "snippets": {
                            "description": "Index snippets matching the query. Emitted on 'web' results; 'news' results carry 'description' instead and have no snippets.",
                            "items": {
                              "type": "string"
                            },
                            "type": "array"
                          },
                          "source_name": {
                            "type": "string"
                          },
                          "thumbnail_url": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "url": {
                            "description": "Result URL.",
                            "type": "string"
                          }
                        },
                        "required": [
                          "url"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    }
                  },
                  "type": "object"
                }
              },
              "required": [
                "results",
                "metadata"
              ],
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

Example shape — generated from the schema, not a captured live response

null

Examples

curl

curl "https://api-staging.you.com/v1/search"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

JavaScript

const res = await fetch("https://api-staging.you.com/v1/search");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

Python

import httpx
res = httpx.get("https://api-staging.you.com/v1/search")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header

Details

Provider: api-staging.you.com
Endpoint: https://api-staging.you.com/v1/search
Machine-readable: /resources/13322.json