Python SDK

Run a search

results = client.search.run(
    site="google",
    query="wireless earbuds",
    pages=3,           # paginate automatically
)
for r in results:
    print(r.position, r.title, r.url)

Bulk-scrape via async batch

asins = ["B08N5KWBKK", "B0DZ7871B8", ...]  # up to 1,000

batch = client.batch.create(
    asins=asins,
    domain="com",
    webhook_url="https://your.app/webhook",  # optional
)

# Poll, or wait for the webhook
results = client.batch.wait(batch.id, timeout=600)
print(f"got {len(results)} products")

Scrape across regions

for tld in ("com", "co.uk", "de", "co.jp"):
    p = client.products.get("B08N5KWBKK", domain=tld)
    print(tld, p.price, p.currency)

The same client works across all 237 targets - swap the endpoint for Walmart, Wikipedia, search engines and more. See /features.

Handle errors and retries

from chocodata import Client, RateLimitError, BlockedError

client = Client(api_key="cd_live_...", max_retries=3)  # retries built in

try:
    p = client.products.get("B08N5KWBKK")
except RateLimitError as e:
    print(f"hit limit, retry after {e.retry_after_ms}ms")
except BlockedError as e:
    print(f"upstream blocked, request_id={e.request_id}")