APIsContents API

Contents API Quickstart

Extract clean Markdown or HTML from URLs you already have.
View as MarkdownOpen in Claude

The Contents API extracts clean HTML or Markdown from URLs you already have. Pass a list of URLs and get back the page content for each—no parsing, no HTML noise, no browser automation.

Get an API key at you.com/platform. New accounts start with $100 in complimentary credits. The samples below read YDC_API_KEY. See the site Quickstart for the five-API tour and API key management for best practices.

from youdotcom import You
from youdotcom.models import ContentsFormats
with You() as you:
    pages = you.contents(
        urls=["https://you.com/about"],
        formats=[ContentsFormats.MARKDOWN],
    )
    for page in pages:
        print(f"Title: {page.title}")
        print(f"Content preview: {page.markdown[:300]}\n")
Try in Postman

Fork the Contents API collection, add your API key to the production environment, and hit Send.

If you have a query rather than URLs, use full page extraction on the Web Search API instead.

Next Steps

Contents API Overview

Formats, timeouts, cache freshness, use cases, and pricing

API reference

Full parameter reference, request/response schemas, and error codes

Web Search API

Discover URLs first, then enrich results with full page content

Site Quickstart

Try all five APIs in one tour