Quickstart
Get your first search results in under 2 minutes.
1. Get Your API Key
The fastest way is to sign in from your terminal (Node.js 18+). It opens a sign-in page, you click Approve, and the key is saved to your shell profile as SCAVIO_API_KEY without being shown:
npx -y scavio@latest loginOr sign up at the Scavio Dashboard and copy your API key from the API Keys page. Keys start with sk_. New accounts get 50 free credits, no card.
2. Make Your First Request
curl -X POST 'https://api.scavio.dev/api/v2/google' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"query": "Scavio search API"}'3. Read the Response
A successful response returns a JSON object with an organic_results array. Each result includes a title, link, and snippet.
{
"organic_results": [
{
"position": 1,
"title": "Scavio - Search API for Developers",
"link": "https://scavio.dev",
"snippet": "One API to search every platform..."
}
],
"search_information": { "total_results": 1250000 },
"response_time": 450,
"credits_used": 1,
"credits_remaining": 999
}4. Try Advanced Parameters
Add optional parameters to customize your search. This example searches from the US, in English, restricted to the last week:
curl -X POST 'https://api.scavio.dev/api/v2/google' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"query": "AI startups funding",
"search_type": "news",
"country_code": "us",
"language": "en"
}'5. Use the Python SDK
The official Python SDK provides a typed client with sync and async support, built-in rate limiting, and access to all 6 data sources.
pip install scavio6. Use with LangChain
Install langchain-scavio to use Scavio as LangChain tools in your agents. Supports Google, Amazon, Walmart, and YouTube.
pip install langchain-scavioNext Steps
- Google Search API -- full endpoint reference with response format
- YouTube API -- search and metadata
- Amazon API -- product search, details, and seller offers
- Walmart API -- product search and details
- Country Codes -- supported country codes reference