composio-scavio

Scavio real-time search tools for Composio.

Scavio is a single Search API over 31 platforms -- Google, YouTube, Amazon, Walmart, eBay, Target, Home Depot, Reddit, TikTok, TikTok Shop, Instagram, X, LinkedIn, Threads, Kuaishou, Zillow, Redfin, Booking.com, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the Apple App Store, Google Play, SEC EDGAR, Companies House, G2, Capterra, Google Ads Transparency and the Meta Ad Library -- plus extract, which reads any URL as Markdown, plain text or raw HTML. This package exposes 189 tools covering every live Scavio endpoint 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).

New in 0.4.0: 21 more platforms, and they are opt-in. Registering all 189 tools at once buries the handful an agent actually wants, so the verticals added in this release are off by default. The ten original platforms and extract stay on (104 tools). Turn a vertical on with its flag -- build_scavio_toolkit(enable_zillow=True) -- or pass all=True for everything. Nothing that worked in 0.3.0 changes, except that Walmart grew from 2 tools to 7.

Walmart was rebuilt (breaking). Walmart now runs on a scrape.do rebuild: device, delivery_zip and store_id never existed on it and are gone, start_page is replaced by page, and five endpoints beyond search/product are exposed for the first time (REVIEWS, CATEGORY, OFFERS, SELLER, SELLER_PRODUCTS). SCAVIO_WALMART_OFFERS returns the buy-box seller only -- there is no way to page the other sellers -- and SCAVIO_WALMART_SELLER_PRODUCTS returns roughly the first 40 items with no pagination at all.

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,
    enable_zillow=True,      # opt-in: off unless you ask for it
)

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)

SCAVIO_EXTRACT is the agent's "read this page" primitive and is on by default:

page = session.tools.execute(
    "SCAVIO_EXTRACT",
    arguments={"url": "https://example.com/pricing", "format": "markdown"},
)

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

Tools

189 tools, all namespaced under the SCAVIO toolkit. Each provider is gated by an enable_* flag. On by default are the ten original platforms and extract (104 tools); the 21 platforms marked opt-in are off unless you pass their flag or all=True.

On by default

Opt-in

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

Resolve first

Six tools exist only to turn a name you have into the id everything else on that platform is keyed by. Call them first, or the rest of the platform is unreachable: SCAVIO_SEC_LOOKUP (ticker to CIK), SCAVIO_GLASSDOOR_COMPANIES (name to employer_id), SCAVIO_TRIPADVISOR_LOCATIONS (name to geo_id + location_id), SCAVIO_GOOGLE_ADS_ADVERTISERS (brand to advertiser_id), SCAVIO_COMPANIES_HOUSE_SEARCH (name to company_number) and SCAVIO_KUAISHOU_USER_RESOLVE (share link to user_id).

Credits

Every tool states its cost in its own description. Flat-priced platforms:

LinkedIn PERSON, PERSON_ABOUT, COMPANY and POST cost 1 credit.

Four surfaces are body-priced -- their cost is a function of the request, not a constant for the route, so no single number can be quoted:

See scavio.dev/docs.

Links

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