Introduction
Scavio is a search API that lets developers retrieve structured search results from multiple platforms with a single POST request. No scraping, no browser automation -- just clean JSON data from a simple API call.
Set up with your AI agent
Using Claude Code, Codex, Pi, Cursor, GitHub Copilot or Windsurf? Paste this into your agent and it sets everything up for you:
Fetch and execute the appropriate instructions to set me up for Scavio from https://scavio.dev/agent-setup/prompt.mdThe agent reads the instructions at that URL and then:
- Installs the Scavio skills. It adds the
scavioskill, which knows every platform, endpoint and credit cost, plus the skill for any platform you name (for example "set me up for Scavio's Amazon API"). Skills load only when a request needs them, so they do not slow your agent down in other sessions. - Signs you in, with no key to copy. It runs
npx -y scavio@latest loginand shows you a link and a code. You open the link, sign in or create a free account (50 free credits, no card), check that the code matches and click Approve. The key is saved to your shell profile asSCAVIO_API_KEYand never appears in the chat. - Checks that it works. It confirms the key against the free usage endpoint (no credits spent) and prints a short setup summary.
- Asks you to restart it. One restart loads both the skills and the key. After that, ask in plain language, for example "find the top Reddit posts about mechanical keyboards" or "get the price and reviews for this Amazon product".
It never edits your CLAUDE.md, AGENTS.md or other instruction files, never asks you to paste a key into the chat, and asks before overwriting a Scavio skill you already have. Every step, per agent, is on the agent setup page.
Supported Platforms
| Platform | Endpoint | Status |
|---|---|---|
| Google Search | POST /api/v2/google | Available |
| YouTube | POST /api/v1/youtube | Available |
| Amazon | POST /api/v1/amazon | Available |
| Walmart | POST /api/v1/walmart | Available |
POST /api/v1/reddit | Available | |
| TikTok | POST /api/v1/tiktok | Available |
POST /api/v1/instagram | Available |
Key Features
- Multi-platform search -- Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram available today
- Advanced parameters -- control search type, country, language, device, pagination, and result depth
- Fast responses -- results returned in milliseconds
- Structured data -- titles, URLs, descriptions, knowledge graphs, related searches, and more in clean JSON
- Credit-based pricing -- start free with 50 signup credits. Most requests cost 1 credit.
- Multi-language support -- works with Python, JavaScript, cURL, or any HTTP client
Quick Example
curl -X POST 'https://api.scavio.dev/api/v2/google' \
-H 'Authorization: Bearer sk_live_your_key' \
-H 'Content-Type: application/json' \
-d '{"query": "Scavio search API"}'Credit Costs
| Endpoints | Credits |
|---|---|
| Google (v2), YouTube, Amazon, Walmart, TikTok | 1 |
| 1 | |
| Instagram (user posts) | 2-10 |
| Instagram (post detail, comment replies) | 8 |
| Instagram (all other endpoints) | 8-10 |
Python SDK
The official Python SDK provides typed clients (sync and async), built-in rate limiting, and access to all 6 data sources from a single client.
pip install scaviofrom scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
results = client.search("best AI tools 2026")
products = client.amazon.search("wireless headphones")
videos = client.youtube.search("python tutorial")
posts = client.reddit.search("web scraping")LangChain Integration
Use Scavio directly in LangChain and LangGraph agents via the langchain-scavio package. 9 tools covering Google, Amazon, Walmart, YouTube, and Reddit -- all with one API key.
pip install langchain-scavioNext Steps
- Quickstart -- get up and running in 2 minutes
- Google Search API -- full endpoint reference with response format
- YouTube API -- search and metadata
- Amazon API -- product search and details
- Walmart API -- product search and details
- Reddit API -- post search and threaded comment extraction
- Country Codes -- supported country codes reference