Search the web
You.com API
Web search API with its own index that returns ranked web and news results as JSON, with optional page content.
At a glance
- Provider
- You.com (SuSea, Inc.)
- Category
- Search the web
- Type
- Hosted API
- Pricing model
- Pay as you go, prepaid credits; keyless pay-per-call by x402 or MPP2
- Free tier
- $10 credit on sign-up plus $90 after account verification, no card; 100 keyless MCP searches a day1
- Authentication
- API key in
X-API-Keyheader; OAuth 2.1 for the MCP server; keyless via x402/MPP payment6 - Connect via
- REST API, hosted MCP server, local MCP package, Python SDK, agent skills8
- Read from the provider's pages
- 2026-11-04
Pricing
- Pricing model: Pay as you go, prepaid credits; Auto Top-Up optional
- Free tier: $10 credit on sign-up and $90 more after verifying the account; free credits valid for 60 days; keyless MCP profile allows 100
you-searchqueries a day - Card required for free tier: No
- Official MCP server: Yes, remote and local
- Address or package:
https://api.you.com/mcp(keyless:https://api.you.com/mcp?profile=free); local@youdotcom-oss/mcp - Number of tools (checked on free profile): 2 tools returned by
tools/liston?profile=free; docs list 6 on the full server
- Who creates the account: A person signs up on the Platform with Google, Apple, email one-time password or SSO; agents can instead pay per request with x402 or MPP and need no account
- Where to get a key:
https://you.com/platform/api-keys; keys are scoped per product and shown once - Other requirements: None for the free credits; $90 of the free credit needs account verification; optional per-key spending cap
- REST API:
https://ydc-index.io/v1/search(search, contents);https://api.you.com(answer, research, finance, router) - MCP server:
https://api.you.com/mcp - OpenAPI spec:
https://you.com/docs/openapi.json
- Results per call: 100 without extraction; 50 with highlights
- Pagination:
offset0 to 9 - Page crawl timeout:
crawl_timeout1 to 60 seconds, default 10
- Data location: Services are provided from the United States
- Retention: Kept for the period necessary to deliver and secure the Services; no fixed period stated
- Used for training: No: prompts, files and outputs are not used to train own models; LLM-provider contracts prohibit their training
Read from You.com (SuSea, Inc.)’s own pages on 2026-11-04. Every number links to the page a value came from. For agents, the same facts as markdown: /tools/search-the-web/you-com.md