composio-scavio

Scavio real-time search tools for Composio.

Scavio is a single Search API over Google, YouTube, Amazon, Walmart, Reddit, TikTok, TikTok Shop, Instagram, X and LinkedIn. This package exposes 97 tools covering every live endpoint of all ten platforms as a Composio custom toolkit, so your agents can pull structured, up-to-date results across any Composio-supported framework (OpenAI, Anthropic, LangChain, CrewAI, and more).

Google v1 is gone. /api/v1/google was retired on 2026-08-04 and now returns 410. Every Google tool here runs on /api/v2/google* and takes v2 params natively: gl (two-letter country), hl (language), google_domain, device, and start. start is a 0-based result OFFSET, not a page number -- 0 is the first page, 10 the second, 20 the third. The old country_code / language / page arguments are removed rather than silently remapped, because mapping a page number onto start fetches the wrong page. Google responses are also FLAT: there is no data wrapper, and results are organic_results[] with link and snippet.

Amazon changed (breaking). The upstream provider moved in 2026-07: domain is replaced by country, a two-letter marketplace code (us, gb -- the UK is gb, not uk -- de, jp, ...), and sort_by, pages, category_id, merchant_id, language, currency, device, zip_code and autoselect_variant are gone. The marketplace ignores all of them (sort_by returns the identical unordered set for every value), so they are removed rather than kept as silent no-ops. Rank and filter results yourself.

Reddit search has no filters. /reddit/search accepts only query and cursor; the API strips anything else, so the old type and sort args narrowed nothing and are removed. It returns data.results with next_cursor and has_more. SCAVIO_REDDIT_POST returns the post itself only -- comments are not included, use SCAVIO_REDDIT_POST_COMMENTS for those. The subreddit and user feeds do return data.posts.

Five LinkedIn endpoints are retired. person/contact, company/people, company/jobs, search/people and search/posts were retired upstream and always answer 410 unbilled, so they are deliberately not registered as tools. Use SCAVIO_LINKEDIN_COMPANY (its featured_employees is a 4-6 person sample) instead of company/people, and SCAVIO_LINKEDIN_SEARCH_JOBS with the company name instead of company/jobs.

Install

pip install composio-scavio

Setup

Get a Scavio API key from the Scavio Dashboard (new accounts get 50 one-time signup credits, no credit card; the free plan does not refill monthly). Set it as an environment variable or pass it directly.

export SCAVIO_API_KEY=sk_...
export COMPOSIO_API_KEY=...   # from https://app.composio.dev

Usage

from composio import Composio
from composio_scavio import build_scavio_toolkit

composio = Composio()

# Build the toolkit; expose only the providers you need.
scavio = build_scavio_toolkit(
    api_key="sk_...",        # or rely on SCAVIO_API_KEY
    enable_google=True,
    enable_amazon=True,
    enable_tiktok=False,
)

session = composio.create(
    user_id="user_1",
    experimental={"custom_toolkits": [scavio]},
)

result = session.tools.execute(
    "SCAVIO_GOOGLE_SEARCH",
    arguments={"query": "best search API for AI agents", "gl": "us", "hl": "en"},
)
print(result)

Pass all=True to register every tool regardless of the individual flags.

Tools

97 tools, all namespaced under the SCAVIO toolkit. Each provider is gated by an enable_* flag.

That is every live Scavio endpoint. Two things are deliberately absent: the deprecated /youtube/metadata alias (identical to SCAVIO_YOUTUBE_VIDEO) and the 5 retired LinkedIn endpoints (always 410, unbilled).

Credits

Every tool states its cost in its own description. The full table:

LinkedIn PERSON, PERSON_ABOUT, COMPANY and POST cost 1 credit. See scavio.dev/docs.

Links

• Scavio: https://scavio.dev
• Docs: https://scavio.dev/docs
• Dashboard: https://dashboard.scavio.dev