> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-codex-docs-audit-20260719-0149.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://scavio.dev) Search API.

## Prerequisites

The following examples require the `agno`, `scavio`, and `openai` libraries and an API key from [Scavio](https://dashboard.scavio.dev/sign-up).

```shell theme={null}
uv pip install -U agno scavio openai
```

```shell theme={null}
export SCAVIO_API_KEY=***
export OPENAI_API_KEY=***
```

## Example

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

```python cookbook/91_tools/scavio_tools.py theme={null}
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:

```python theme={null}
# 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](https://github.com/agno-agi/agno/blob/v2.7.4/libs/agno/agno/tools/scavio.py)
* [Cookbook](https://github.com/agno-agi/agno/blob/v2.7.4/cookbook/91_tools/scavio_tools.py)