Skip to main content
ScavioTools enable an Agent to search across Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram using the Scavio unified Search API.

​
Prerequisites

The following examples require the scavio library and an API key from Scavio. 
uv pip install -U scavio

export SCAVIO_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

agent = Agent(tools=[ScavioTools()], markdown=True)
agent.print_response("Search for the GitHub repo of the Agno framework")
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

ParameterTypeDefaultDescription
api_keyOptional[str]NoneScavio API key. If not provided, uses the SCAVIO_API_KEY environment variable.
enable_googleboolTrueRegister the Google web search tool.
enable_amazonboolTrueRegister the Amazon search and product tools.
enable_walmartboolTrueRegister the Walmart search and product tools.
enable_youtubeboolTrueRegister the YouTube search and metadata tools.
enable_redditboolTrueRegister the Reddit search and post tools.
enable_tiktokboolTrueRegister the TikTok tools.
enable_instagramboolTrueRegister the Instagram tools.
allboolFalseRegister 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.
FunctionDescription
google_searchSearch Google for real-time web results.
amazon_search, amazon_productSearch Amazon products and fetch a product by ASIN.
walmart_search, walmart_productSearch Walmart products and fetch a product by product ID.
youtube_search, youtube_metadataSearch YouTube videos and fetch video metadata.
reddit_search, reddit_postSearch 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_followingsTikTok 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_followingsInstagram profiles, posts, reels, stories, comments, search, hashtags, and social graph.

​
Developer Resources