Scavio

Search Google, YouTube, marketplaces, and social platforms through the Scavio API.

ScavioTools gives an agent access to Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram through the Scavio Search API.

Prerequisites

The following examples require the agno, scavio, and openai libraries and an API key from Scavio.

uv pip install -U agno scavio openai

export SCAVIO_API_KEY=***
export OPENAI_API_KEY=***

Example

The following agent will search Google via Scavio and print the response.

cookbook/91_tools/scavio_tools.py

from agno.agent import Agent
from agno.tools.scavio import ScavioTools

web_agent = Agent(
    tools=[
        ScavioTools(
            enable_google=True,
            enable_youtube=True,
            enable_reddit=True,
            enable_amazon=False,
            enable_walmart=False,
            enable_tiktok=False,
            enable_instagram=False,
        )
    ]
)

web_agent.print_response(
    "Search Google for the latest news on AI agent frameworks",
    markdown=True,
    stream=True,
)

Every provider is enabled by default. Use the enable_* flags to expose only the tools you need:

# Web-only agent: Google, YouTube, Reddit
agent = Agent(
    tools=[
        ScavioTools(
            enable_google=True,
            enable_youtube=True,
            enable_reddit=True,
            enable_amazon=False,
            enable_walmart=False,
            enable_tiktok=False,
            enable_instagram=False,
        )
    ],
    markdown=True,
)

Toolkit Params

Parameter	Type	Default	Description
api_key	Optional[str]	None	Scavio API key. If not provided, uses the SCAVIO_API_KEY environment variable.
enable_google	bool	True	Register the Google web search tool.
enable_amazon	bool	True	Register the Amazon search and product tools.
enable_walmart	bool	True	Register the Walmart search and product tools.
enable_youtube	bool	True	Register the YouTube search and metadata tools.
enable_reddit	bool	True	Register the Reddit search and post tools.
enable_tiktok	bool	True	Register the TikTok tools.
enable_instagram	bool	True	Register the Instagram tools.
all	bool	False	Register every available tool, ignoring the individual flags.

Toolkit Functions

Each function returns the Scavio response as a JSON string. Errors are returned as {"error": "..."} rather than raised.

Function	Description
google_search	Search Google for real-time web results.
amazon_search, amazon_product	Search Amazon products and fetch a product by ASIN.
walmart_search, walmart_product	Search Walmart products and fetch a product by product ID.
youtube_search, youtube_metadata	Search YouTube videos and fetch video metadata.
reddit_search, reddit_post	Search Reddit and fetch a post with its comment tree.
tiktok_profile, tiktok_user_posts, tiktok_video, tiktok_video_comments, tiktok_comment_replies, tiktok_search_videos, tiktok_search_users, tiktok_hashtag, tiktok_hashtag_videos, tiktok_user_followers, tiktok_user_followings	TikTok profiles, videos, comments, search, hashtags, and social graph.
instagram_profile, instagram_user_posts, instagram_user_reels, instagram_user_tagged, instagram_user_stories, instagram_post, instagram_post_comments, instagram_comment_replies, instagram_search_users, instagram_search_hashtags, instagram_user_followers, instagram_user_followings	Instagram profiles, posts, reels, stories, comments, search, hashtags, and social graph.

Developer Resources

• Tools
• Cookbook