autogen-scavio 0.2.1

AutoGen integration for Scavio Search API -- real-time Google, Amazon, Walmart, YouTube, Reddit, TikTok, and Instagram search tools for AI agents

autogen-scavio

AutoGen integration for the Scavio Search API. Provides 32 search tools across Google, Amazon, Walmart, YouTube, Reddit, TikTok, and Instagram for use with AutoGen AI agents.

Installation

pip install autogen-scavio

Setup

Get a free API key at dashboard.scavio.dev and set it as an environment variable:

export SCAVIO_API_KEY="sk_live_..."

Quick Start

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()

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:

# Only Google and Amazon tools
tools = create_scavio_tools(providers=["google", "amazon"])

# Only YouTube
tools = create_scavio_tools(providers=["youtube"])

# 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)

Available Tools

Provider	Tool	Description
Google	scavio_web_search	Web search with knowledge graphs and related questions
Amazon	scavio_amazon_search	Product search across 20+ marketplaces
Amazon	scavio_amazon_product	Product details by ASIN
YouTube	scavio_youtube_search	Video search with filters
YouTube	scavio_youtube_metadata	Video metadata by ID
Walmart	scavio_walmart_search	Product search with price/fulfillment filters
Walmart	scavio_walmart_product	Product details by ID
Reddit	scavio_reddit_search	Post and comment search
Reddit	scavio_reddit_post	Post metadata and comments by URL
TikTok	scavio_tiktok_profile	User profile lookup
TikTok	scavio_tiktok_user_posts	User's posted videos
TikTok	scavio_tiktok_video	Video details
TikTok	scavio_tiktok_video_comments	Video comments
TikTok	scavio_tiktok_comment_replies	Comment replies
TikTok	scavio_tiktok_search_videos	Video search by keyword
TikTok	scavio_tiktok_search_users	User search by keyword
TikTok	scavio_tiktok_hashtag	Hashtag info
TikTok	scavio_tiktok_hashtag_videos	Videos by hashtag
TikTok	scavio_tiktok_user_followers	User's followers
TikTok	scavio_tiktok_user_followings	User's followings
Instagram	scavio_instagram_profile	User profile lookup
Instagram	scavio_instagram_user_posts	User's posts
Instagram	scavio_instagram_user_reels	User's reels
Instagram	scavio_instagram_user_tagged	Posts user is tagged in
Instagram	scavio_instagram_user_stories	User's active stories
Instagram	scavio_instagram_post	Post details by url, media_id, or shortcode
Instagram	scavio_instagram_post_comments	Post comments
Instagram	scavio_instagram_comment_replies	Comment replies
Instagram	scavio_instagram_search_users	User search by keyword
Instagram	scavio_instagram_search_hashtags	Hashtag search by keyword
Instagram	scavio_instagram_user_followers	User's followers
Instagram	scavio_instagram_user_followings	User's followings

Configuration

from autogen_scavio import configure

# Set API key programmatically
configure(api_key="sk_live_...")

# Or pass to factory
tools = create_scavio_tools(api_key="sk_live_...", max_results=10)

About Scavio

Scavio is a unified search API built for AI agents — one API key, structured JSON, no scraping or proxies. A real-time Tavily alternative and SerpAPI alternative with data from:

• Google Search API — SERP results, news, images, maps, and knowledge graph
• Amazon Product API and Walmart API — product search and details
• YouTube API, TikTok API, and Instagram API — video and social media data
• Reddit API — posts and threaded comments

Get a free API key and explore the documentation.