You.com Search API

Endpoints and prices

Payment evidence

402 payload captured at 2026-10-07 10:23:01 UTC. Check evidence JSON · Measurement methodology.

{
  "error": "Payment required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0xc327D0aEb5f65B514b193b5e5A95cC6F4060815f",
      "amount": "5000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 600
    },
    {
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "extra": {
        "feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F"
      },
      "payTo": "GBQ2FrH49gvKXu1zg7tguoLwaofn5S4NnuMs5JSYQ5GX",
      "amount": "5000",
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "maxTimeoutSeconds": 600
    }
  ],
  "resource": {
    "url": "https://api.you.com/v1/search",
    "mimeType": "application/json",
    "description": "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."
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "count": 10,
            "query": "NVDA earnings guidance Q2 2026"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "results": {
              "web": [
                {
                  "url": "https://example.com/nvda-guidance",
                  "title": "NVIDIA raises Q2 revenue guidance",
                  "page_age": "2026-08-01T14:02:00",
                  "snippets": [
                    "NVIDIA expects revenue of ... driven by data-center GPU demand."
                  ],
                  "description": "NVIDIA lifted its outlook on data-center demand.",
                  "favicon_url": "https://example.com/favicon.ico",
                  "thumbnail_url": "https://example.com/thumb/nvda-guidance.jpg"
                }
              ],
              "news": [
                {
                  "url": "https://example.com/nvda-earnings-call",
                  "title": "NVIDIA earnings call: guidance above consensus",
                  "page_age": "2026-08-01T14:02:00",
                  "description": "Management guided next quarter above consensus.",
                  "thumbnail_url": "https://example.com/thumb/nvda-call.jpg"
                }
              ]
            },
            "metadata": {
              "query": "NVDA earnings guidance Q2 2026",
              "latency": 0.42,
              "search_uuid": "0a1d1f6e-6a1a-4a6e-9a9a-5f4f2b7d3c11"
            }
          }
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "required": [
              "type",
              "method"
            ],
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "enum": [
                  "GET",
                  "HEAD",
                  "DELETE"
                ],
                "type": "string"
              },
              "queryParams": {
                "type": "object",
                "required": [
                  "query"
                ],
                "properties": {
                  "count": {
                    "type": "integer",
                    "default": 10,
                    "maximum": 100,
                    "minimum": 1,
                    "description": "Number of results to return, capped at 100. Also sets the number of pages charged for when livecrawl is enabled."
                  },
                  "query": {
                    "type": "string",
                    "maxLength": 40000,
                    "description": "The web search query."
                  },
                  "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'."
                  },
                  "livecrawl": {
                    "enum": [
                      "web",
                      "news",
                      "all"
                    ],
                    "type": "string",
                    "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."
                  }
                }
              }
            },
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "type": "string"
              },
              "example": {
                "type": "object",
                "required": [
                  "results",
                  "metadata"
                ],
                "properties": {
                  "results": {
                    "type": "object",
                    "properties": {
                      "web": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "url"
                          ],
                          "properties": {
                            "url": {
                              "type": "string",
                              "description": "Result URL."
                            },
                            "title": {
                              "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."
                            },
                            "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'."
                            },
                            "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."
                            },
                            "description": {
                              "type": "string"
                            },
                            "favicon_url": {
                              "type": "string"
                            },
                            "source_name": {
                              "type": "string"
                            },
                            "thumbnail_url": {
                              "type": "string"
                            },
                            "original_thumbnail_url": {
                              "type": "string"
                            }
                          }
                        }
                      },
                      "news": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "url"
                          ],
                          "properties": {
                            "url": {
                              "type": "string",
                              "description": "Result URL."
                            },
                            "title": {
                              "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."
                            },
                            "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'."
                            },
                            "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."
                            },
                            "description": {
                              "type": "string"
                            },
                            "favicon_url": {
                              "type": "string"
                            },
                            "source_name": {
                              "type": "string"
                            },
                            "thumbnail_url": {
                              "type": "string"
                            },
                            "original_thumbnail_url": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "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 '{}'.",
                    "additionalProperties": {
                      "type": "array"
                    }
                  },
                  "metadata": {
                    "type": "object",
                    "required": [
                      "query",
                      "search_uuid",
                      "latency"
                    ],
                    "properties": {
                      "query": {
                        "type": "string",
                        "description": "The query as searched."
                      },
                      "latency": {
                        "type": "number",
                        "description": "Server-side latency in seconds."
                      },
                      "search_uuid": {
                        "type": "string",
                        "description": "Request identifier, useful when reporting issues."
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x402Version": 2
}

{
  "error": "Payment required",
  "accepts": [
    {
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "payTo": "0xc327D0aEb5f65B514b193b5e5A95cC6F4060815f",
      "amount": "110000",
      "scheme": "exact",
      "network": "eip155:8453",
      "maxTimeoutSeconds": 600
    },
    {
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "extra": {
        "feePayer": "Hc3sdEAsCGQcpgfivywog9uwtk8gUBUZgsxdME1EJy88"
      },
      "payTo": "GBQ2FrH49gvKXu1zg7tguoLwaofn5S4NnuMs5JSYQ5GX",
      "amount": "110000",
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "maxTimeoutSeconds": 600
    }
  ],
  "resource": {
    "url": "https://api.you.com/v1/finance_research",
    "mimeType": "application/json",
    "description": "You.com Finance Research API: agentic deep research on a financial question, returning a synthesized answer with cited sources. Use when an agent needs well-reasoned market or company analysis for a trading or investment decision. JSON body: input (required question), research_effort (standard | deep | exhaustive, default deep). Paid per call in USDC. Async: paying returns a jobId; poll the SIWX-authed poll_url for the result (deep research takes 1-3 min)."
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "input": "What is the bull vs bear case for NVDA over the next 12 months?",
            "research_effort": "deep"
          },
          "type": "http",
          "method": "POST",
          "bodyType": "json"
        },
        "output": {
          "type": "json",
          "example": {
            "jobId": "b2042efe-4cfc-4df5-be39-35be7880c60e",
            "status": "pending",
            "poll_url": "/x402/finance_research/results/b2042efe-4cfc-4df5-be39-35be7880c60e"
          }
        }
      },
      "schema": {
        "type": "object",
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "required": [
          "input"
        ],
        "properties": {
          "input": {
            "type": "object",
            "required": [
              "type",
              "method",
              "bodyType",
              "body"
            ],
            "properties": {
              "body": {
                "required": [
                  "input"
                ],
                "properties": {
                  "input": {
                    "type": "string",
                    "maxLength": 40000,
                    "description": "The finance research question."
                  },
                  "research_effort": {
                    "enum": [
                      "standard",
                      "deep",
                      "exhaustive"
                    ],
                    "type": "string",
                    "default": "deep",
                    "description": "Research depth. Higher effort costs more per call: standard, deep, exhaustive."
                  }
                },
                "additionalProperties": false
              },
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "enum": [
                  "POST",
                  "PUT",
                  "PATCH"
                ],
                "type": "string"
              },
              "bodyType": {
                "enum": [
                  "json",
                  "form-data",
                  "text"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "required": [
              "type"
            ],
            "properties": {
              "type": {
                "type": "string"
              },
              "example": {
                "type": "object"
              }
            }
          }
        }
      }
    }
  },
  "x402Version": 2
}