AutoGen Integration
Integrate Scavio with Microsoft AutoGen to give your agents real-time data across 31 platforms — Google, YouTube, Amazon, Walmart, Target, eBay, Home Depot, Reddit, TikTok, TikTok Shop, Instagram, X, Threads, Kuaishou, LinkedIn, Indeed, Glassdoor, Zillow, Redfin, Booking.com, Airbnb, Tripadvisor, Yelp, the Apple App Store, Google Play, SEC EDGAR, Companies House, G2, Capterra, Google Ads Transparency and the Meta Ad Library. The autogen-scavio package ships 188 tools, plus scavio_extract for any URL, ready to hand to any AutoGen AssistantAgent — a cost-effective Tavily and SerpAPI alternative.
One call, 188 tools
create_scavio_tools() returns ready-to-use AutoGen tools. Load every provider, or pass providers=[...] to load only the ones your agent needs — 188 tools is far more than any single agent should carry at once.Introduction
The autogen-scavio package wraps the Scavio API as native AutoGen tools built on autogen-core. Each tool returns structured JSON, so agents can search, compare, and reason over live data without scraping or proxies.
Step-by-Step Integration Guide
Step 1: Install the package
pip install autogen-scavioStep 2: Set your API key
Get a key at dashboard.scavio.dev, then expose it as the SCAVIO_API_KEY environment variable:
export SCAVIO_API_KEY=sk_live_...Step 3: Give the tools to an agent
Load only the providers the agent needs. Handing a model all 188 tools at once bloats the prompt and makes routing worse, so providers=[...] is the normal path:
import asyncio
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient
from autogen_scavio import create_scavio_tools
tools = create_scavio_tools(providers=["google", "reddit", "extract"])
agent = AssistantAgent(
name="researcher",
model_client=OpenAIChatCompletionClient(model="gpt-5.5"),
tools=tools,
system_message="You are a research assistant with access to search tools.",
)
async def main():
result = await agent.run(task="What are the top AI agent frameworks in 2026?")
print(result.messages[-1].content)
asyncio.run(main())Selective tool loading
Load only the providers you need, or build individual tools:
# Only Google and Amazon tools
tools = create_scavio_tools(providers=["google", "amazon"])
# A shopping agent across four retailers
tools = create_scavio_tools(providers=["amazon", "walmart", "target", "ebay"])
# Read-any-URL only
tools = create_scavio_tools(providers=["extract"])
# Individual tool factories
from autogen_scavio import create_web_search_tool, create_amazon_search_tool
web_tool = create_web_search_tool(max_results=10)
amazon_tool = create_amazon_search_tool(max_results=5)Valid provider keys: extract, google, youtube, amazon, walmart, target, ebay, home_depot, reddit, tiktok, tiktok_shop, instagram, x, threads, kuaishou, linkedin, indeed, glassdoor, zillow, redfin, booking, airbnb, tripadvisor, yelp, app_store, google_play, sec, companies_house, g2, capterra, google_ads, meta_ads.
Configuration
from autogen_scavio import configure
# Set the API key programmatically
configure(api_key="sk_live_...")
# Or pass it to the factory
tools = create_scavio_tools(api_key="sk_live_...", max_results=10)Available Tools
188 tools across 31 platforms, plus scavio_extract, which belongs to no platform:
| Provider | Tools | Coverage |
|---|---|---|
| Extract (any URL) | 1 | Read any page as Markdown, plain text, or raw HTML |
| 14 | Every v2 endpoint: search, AI Mode, Maps, Shopping, Flights, Hotels, News, Trends | |
| YouTube | 15 | Every live endpoint |
| Kuaishou | 14 | Every endpoint |
| 12 | Every endpoint | |
| 12 | Every endpoint | |
| TikTok | 11 | Every endpoint |
| X (formerly Twitter) | 11 | Every endpoint |
| 9 | Every live endpoint | |
| TikTok Shop | 8 | Every endpoint |
| Walmart | 7 | Every endpoint |
| Threads | 6 | Every endpoint |
| SEC EDGAR | 6 | Every endpoint |
| Target | 4 | Every endpoint |
| Tripadvisor | 4 | Every endpoint |
| Indeed | 4 | Every endpoint |
| Glassdoor | 4 | Every endpoint |
| Companies House | 4 | Every endpoint |
| Amazon | 3 | Search, product, offers |
| eBay | 3 | Every endpoint, live and sold listings |
| Home Depot | 3 | Every endpoint |
| Zillow | 3 | Every endpoint |
| Redfin | 3 | Every endpoint |
| Booking.com | 3 | Every endpoint |
| Airbnb | 3 | Every endpoint |
| Yelp | 3 | Every endpoint |
| App Store | 3 | Every endpoint |
| Google Play | 3 | Every endpoint |
| G2 | 3 | Every endpoint |
| Capterra | 3 | Every endpoint |
| Google Ads Transparency | 3 | Every endpoint |
| Meta Ad Library | 3 | Every endpoint |
create_scavio_tools() also returns scavio_youtube_metadata, a deprecated alias of scavio_youtube_video kept for backwards compatibility. It is not counted above — use the video tool in new code.
Five providers are lookup-first
scavio_tripadvisor_locations, scavio_glassdoor_companies, scavio_sec_lookup, scavio_google_ads_advertisers and scavio_companies_house_search — then pass the id it returns to the detail and review tools.Every tool states its own credit cost in its description. Costs are not uniform: YouTube search is 2 and transcript is 8, Instagram ranges from 2 to 10, G2 is 5, Kuaishou ranges from 1 to 40, and LinkedIn job detail is 30. scavio_extract is priced by mode rather than per call — 1 on normal and advanced, 2 on ultra.
Benefits of Scavio + AutoGen
- 188 tools: search, retail, video, social, real estate, travel, jobs, app stores, filings, software reviews, and ad transparency in one package.
- Selective loading: hand agents only the providers they need, out of 31 platforms plus Extract.
- Read anything:
scavio_extractturns any URL into clean Markdown, with no headless browser to run. - Structured JSON: no scraping, proxies, or HTML parsing.
- Cost-effective: most calls cost a single credit.
Next Steps
- API reference -- every endpoint behind these tools
- Google Search API -- endpoint reference and parameters
- Extract API -- the endpoint behind
scavio_extract - Python SDK -- the client that powers these tools
- MCP Integration -- the full hosted tool catalog