Python SDK Reference
The scavio package ships a synchronous ScavioClient and an asynchronous AsyncScavioClient. Both expose the same namespaces and methods.
Client
Python
from scavio import ScavioClient, AsyncScavioClient
client = ScavioClient(
api_key="sk_live_your_key", # or SCAVIO_API_KEY env var
timeout=30.0,
max_retries=2,
)| Option | Type | Default | Description |
|---|---|---|---|
api_key | str | SCAVIO_API_KEY | Your API key. Falls back to the environment variable. |
base_url | str | https://api.scavio.dev | API base URL. |
timeout | float | 30.0 | Per-request timeout in seconds. |
max_retries | int | 2 | Automatic retries for 429/5xx and network errors. |
Namespaces
Each platform is a namespace on the client. Methods return the API response as a dict.
| Namespace | Example methods |
|---|---|
client.google | search, ai_mode, maps_search, maps_place, maps_reviews, shopping, flights, hotels, news, trends |
client.youtube | search, metadata |
client.amazon | search, product, offers |
client.walmart | search, product |
client.reddit | search, post |
client.tiktok | search_videos, profile, video, hashtag |
client.instagram | profile, user_posts, user_reels, search_users |
Errors
Failed requests raise a ScavioError (with subclasses for authentication, rate limiting, and validation). See Errors for status codes and the error body shape.