Quickstart

Get your first search results in under 2 minutes.

1. Get Your API Key

Sign up at the Scavio Dashboard and create an API key from the API Keys page. Your key will start with sk_live_ or sk_test_.

2. Make Your First Request

curl -X POST 'https://api.scavio.dev/api/v1/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 a results array. Each result includes a title, url, and content.

{
  "results": [
    {
      "title": "Scavio - Search API for Developers",
      "url": "https://scavio.dev",
      "content": "One API to search every platform...",
      "position": 1
    }
  ],
  "query": "Scavio search API",
  "response_time": 450,
  "credits_used": 1,
  "credits_remaining": 999
}

4. Try Advanced Parameters

Add optional parameters to customize your search. This example searches news in the US:

curl -X POST 'https://api.scavio.dev/api/v1/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 scavio

6. Use with LangChain

Install langchain-scavio to use Scavio as LangChain tools in your agents. Supports Google, Amazon, Walmart, and YouTube.

pip install langchain-scavio

Next Steps

• 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
• Country Codes -- supported country codes reference