Developer guide

1
import time
2
import requests
3
4
def make_request_with_retry(url, headers):
5
    response = requests.get(url, headers=headers)
6
7
    if response.status_code == 429:
8
        retry_after = int(response.headers.get('Retry-After', 60))
9
        print(f"Rate limited. Retrying after {retry_after} seconds...")
10
        time.sleep(retry_after)
11
        return make_request_with_retry(url, headers)
12
13
    return response

1
# ✅ Good: Using SDK
2
import os
3
from youdotcom import You
4
5
with You(api_key_auth=os.getenv("api_key")) as you:
6
    response = you.search.unified(query="example")
7
8
# ❌ Less ideal: Manual requests
9
import requests
10
response = requests.get(
11
    "https://ydc-index.io/v1/search",
12
    params={"query": "example"},
13
    headers={"X-API-Key": os.getenv("api_key")}
14
)

1
import time
2
from youdotcom import You, errors
3
4
def exponential_backoff(attempt):
5
    return min(2 ** attempt, 60)  # Max 60 seconds
6
7
with You(api_key_auth="api_key") as you:
8
    for attempt in range(5):
9
        try:
10
            response = you.search.unified(query="test")
11
            break
12
        except errors.YouError as e:
13
            if e.status_code == 429 and attempt < 4:
14
                wait_time = exponential_backoff(attempt)
15
                time.sleep(wait_time)
16
            else:
17
                raise

1
from functools import lru_cache
2
from youdotcom import You
3
4
you = You(api_key_auth="api_key")
5
6
@lru_cache(maxsize=100)
7
def cached_search(query: str):
8
    return you.search.unified(query=query)

1
from youdotcom import You, errors
2
3
with You(api_key_auth="api_key") as you:
4
    try:
5
        response = you.search.unified(query=user_query)
6
    except errors.YouError as e:
7
        if e.status_code == 401:
8
            print("Configuration error. Please check your API key.")
9
        elif e.status_code == 429:
10
            print("Too many requests. Please try again in a moment.")
11
        else:
12
            print(f"API error: {e.message}")