The Search Layer Behind Stripe's Agentic Commerce

from youdotcom import You

with You("<apiKey>") as you:
    res = you.search.unified(
        query="best practices for scaling microservices architecture in production",
    )

    # Each result contains a title, URL, snippets and more
    if res.results and res.results.web:
        for result in res.results.web:
            print(f"Title: {result.title}")
            print(f"URL: {result.url}")
            if result.snippets:
                print(f"Snippet: {result.snippets[0]}\n")

from youdotcom import You
from youdotcom.models import ContentsFormats

with You("<apiKey>") as you:
    res = you.contents.generate(
        urls=[
            "https://www.python.org",
            "https://www.example.com",
        ],
        formats=[ContentsFormats.HTML],
    )

    # Access the full page content in your chosen format
    for page in res:
        print(f"Title: {page.title}")
        print(f"HTML: {page.html}...")

from youdotcom import You
from youdotcom.models import ResearchEffort
 
you = You(api_key_auth="api_key")
 
res = you.research(
    input="Which global cities improved air quality the most over the past 10 years, and what measurable actions contributed?",
    research_effort=ResearchEffort.LITE,
)
 
print(res.output.content)
 
for i, source in enumerate(res.output.sources, 1):
    print(f"[{i}] {source.title or 'Untitled'}: {source.url}")

import requests

url = "https://api.you.com/v1/finance_research"
headers = {
    "X-API-Key": "<YOUR_API_KEY>",
    "Content-Type": "application/json",
}
payload = {
    "input": "Compare the free cash flow generation and capital allocation strategies of Apple, Microsoft, and Alphabet over the past three fiscal years",
    "research_effort": "deep",
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
data = response.json()

print(data["output"]["content"])

for i, source in enumerate(data["output"]["sources"], 1):
    print(f"[{i}] {source.get('title') or 'Untitled'}: {source['url']}")