Scavio provides a REST API that you can call from any Python application. Send a POST request with your query, get structured JSON back. Here is how to use every platform.
Google Search
Web search with knowledge graph, PAA, and AI overviews.
Python
import requests
API_KEY = "your_scavio_api_key"
response = requests.post(
"https://api.scavio.dev/api/v1/search",
headers={
"x-api-key": API_KEY,
"Content-Type": "application/json",
},
json={"query": query},
)
data = response.json()
for result in data.get("organic_results", [])[:5]:
print(f"{result['position']}. {result['title']}")
print(f" {result['link']}\n")Amazon Search
Product search with prices, ratings, and reviews.
Python
import requests
API_KEY = "your_scavio_api_key"
response = requests.post(
"https://api.scavio.dev/api/v1/amazon/search",
headers={
"x-api-key": API_KEY,
"Content-Type": "application/json",
},
json={"query": query, "marketplace": "us"},
)
data = response.json()
for product in data.get("products", [])[:5]:
print(f"{product['title']} — {product.get('price', 'N/A')} ({product.get('rating', 'N/A')}⭐)")Reddit Search
Community, posts & threaded comments from any subreddit.
Python
import requests
API_KEY = "your_scavio_api_key"
response = requests.post(
"https://api.scavio.dev/api/v1/reddit/search",
headers={
"x-api-key": API_KEY,
"Content-Type": "application/json",
},
json={"query": query, "sort": "new"},
)
data = response.json()
for post in data["data"].get("posts", [])[:5]:
print(f"r/{post['subreddit']} — {post['title']}")
print(f" by u/{post['author']}")YouTube Search
Video search with transcripts and metadata.
Python
import requests
API_KEY = "your_scavio_api_key"
response = requests.post(
"https://api.scavio.dev/api/v1/youtube/search",
headers={
"x-api-key": API_KEY,
"Content-Type": "application/json",
},
json={"query": query},
)
data = response.json()
for video in data.get("videos", [])[:5]:
print(f"{video['title']} — {video.get('views', 'N/A')} views")Walmart Search
Product search with pricing and fulfillment data.
Python
import requests
API_KEY = "your_scavio_api_key"
response = requests.post(
"https://api.scavio.dev/api/v1/walmart/search",
headers={
"x-api-key": API_KEY,
"Content-Type": "application/json",
},
json={"query": query},
)
data = response.json()
for product in data.get("products", [])[:5]:
print(f"{product['title']} — {product.get('price', 'N/A')} ({product.get('rating', 'N/A')}⭐)")Error Handling
The API returns standard HTTP status codes. Check for 200 (success), 401 (invalid API key), 429 (rate limit), and 500 (server error). The response body always includes a descriptive error message.
Next Steps
- Quickstart guide — get your API key and make your first request
- Rate limits — understand credit usage and limits
- Error reference — full list of error codes and troubleshooting