Quickstart

You.com gives you real-time web intelligence through two primary APIs: the Search API and the Contents API. This page gets you from zero to a working request — and tells you exactly how to evaluate us.

What You.com offers

Step 1: Get your API key

Sign in or create an account at https://you.com/platform/api-keys. You’ll start with $100 in complimentary credits — no credit card required.

Step 2: Try the Search API

The Search API takes a natural language query and returns structured web and news results.

1
from youdotcom import You
2
3
you = You("YOUR_API_KEY")
4
5
results = you.search.unified(query="global birth rate trends", count=5)
6
7
for result in results.results.web:
8
    print(result.title)
9
    print(result.url)
10
    if result.snippets:
11
        print(result.snippets[0])
12
    print()

You’ll get back structured JSON like this:

1
{
2
  "results": {
3
    "web": [
4
      {
5
        "url": "https://www.worldbank.org/en/topic/population",
6
        "title": "Population | World Bank",
7
        "description": "The World Bank tracks global birth rate and population trends.",
8
        "snippets": [
9
          "Global fertility rates have declined significantly over the past five decades, falling from an average of 5 births per woman in 1960 to around 2.3 today."
10
        ],
11
        "page_age": "2025-10-01T00:00:00",
12
        "authors": [],
13
        "favicon_url": "https://ydc-index.io/favicon?domain=worldbank.org&size=128"
14
      }
15
    ]
16
  },
17
  "metadata": {
18
    "query": "global birth rate trends",
19
    "search_uuid": "a1b2c3d4-0000-0000-0000-000000000000",
20
    "latency": 0.38
21
  }
22
}

Power it up with livecrawl

By default, each result includes snippets — short, query-relevant text extracts. Add livecrawl and each result also returns the full page content as clean Markdown or HTML. This is the difference between ~200 words of context and 2,000–10,000 words.

1
from youdotcom import You
2
3
you = You("YOUR_API_KEY")
4
5
results = you.search.unified(
6
    query="global birth rate trends",
7
    count=5,
8
    livecrawl="all",
9
    livecrawl_formats="markdown",
10
)
11
12
for result in results.results.web:
13
    if result.contents:
14
        print(f"{result.title}")
15
        print(result.contents.markdown[:400])
16
        print()

Results that support live crawling will include a contents.markdown field with the full page. For RAG pipelines that need deep context rather than surface-level snippets, this is the parameter to reach for.

Full Search API reference and all parameters

Step 3: Try the Contents API

The Contents API fetches content from URLs you specify, either as raw HTML, Markdown or both.

1
import requests
2
3
response = requests.post(
4
    "https://ydc-index.io/v1/contents",
5
    headers={
6
        "X-API-Key": "YOUR_API_KEY",
7
        "Content-Type": "application/json",
8
    },
9
    json={
10
        "urls": [
11
            "https://competitor-a.com/pricing",
12
            "https://competitor-b.com/pricing",
13
        ],
14
        "formats": ["markdown"],
15
    },
16
)
17
18
for page in response.json():
19
    print(f"=== {page['title']} ===")
20
    print(page["markdown"][:500])
21
    print()

Each URL comes back as a structured object:

1
[
2
  {
3
    "url": "https://competitor-a.com/pricing",
4
    "title": "Pricing — Competitor A",
5
    "markdown": "# Pricing\n\n## Starter\n$49/month...",
6
    "metadata": {
7
      "site_name": "Competitor A",
8
      "favicon_url": "https://ydc-index.io/favicon?domain=competitor-a.com&size=128"
9
    }
10
  }
11
]

Full Contents API reference and all parameters

More ways to explore

Explore the APIs interactively right here in the docs

• Search API playground
• Contents API playground

Use the SDKs

Benefit from ergonomic API access, type safety and easy readability.

• Python SDK
• TypeScript SDK

Use a coding agent to write your integration

There are 2 easy ways to create context for your agent:

1. Add /llms-full.txt to any URL path on this site to obtain the full content of a page in plain-text. For example, docs.you.com/llms-full.txt contains complete documentation content including the full text of all pages. This includes the complete API reference with resolved OpenAPI specifications and SDK code examples for enabled languages.

2. Enable your agent to automatically discover and understand You.com APIs using our documentation-specific MCP server. Simply add the following wherever you store your MCP config:

"docs.you.com": {
  "name": "docs.you.com",
  "url": "https://docs.you.com/_mcp/server",
  "headers": {}
}

Now your agent can automatically search the entirety of the You.com documentation as necessary.

Evaluate You.com

When you’re ready to run a structured evaluation, start simple: use count=10 with no filters, measure accuracy and latency on a representative query set, then add livecrawl if snippets aren’t providing enough context.

• How to Evaluate the Search API — methodology, dataset recommendations (SimpleQA, FRAMES, FreshQA), latency benchmarking, and a production checklist
• Agentic Web Search Playoffs — open-source benchmark comparing web search providers in agentic workflows

Our team can also design and run custom benchmarks for your use case. Talk to us

Pricing

Pricing is based on API calls, with additional costs for live crawling. See the full breakdown at you.com/platform/upgrade or reach out to api@you.com.