Integration: Scavio

Search the web using Scavio, a unified search API for AI agents

Authors

Scavio

Overview
Installation
Usage
- ScavioWebSearch
License

Overview

Scavio is a unified search API built for AI agents. It provides real-time search across Google, YouTube, Amazon, Walmart, Reddit, TikTok, and more through a single API, returning structured results with content and source URLs.

This integration provides:

ScavioWebSearch: Searches the web using Scavio’s Google web search endpoint and returns results as Haystack Document objects along with source URLs.

You need a Scavio API key to use this integration. You can get one at dashboard.scavio.dev.

Installation

pip install scavio-haystack

Usage

ScavioWebSearch

ScavioWebSearch queries the Scavio search API and returns results as Haystack Document objects containing the content snippets and metadata (title, URL). Source URLs are also returned separately.

Set your API key as the SCAVIO_API_KEY environment variable.

Basic Example

from haystack_integrations.components.websearch.scavio import ScavioWebSearch

web_search = ScavioWebSearch(top_k=5)

result = web_search.run(query="What is Haystack by deepset?")
documents = result["documents"]
links = result["links"]

Async Support

The component supports asynchronous execution via run_async:

import asyncio
from haystack_integrations.components.websearch.scavio import ScavioWebSearch

async def main():
    web_search = ScavioWebSearch(top_k=3)
    result = await web_search.run_async(query="What is Haystack by deepset?")
    print(f"Found {len(result['documents'])} documents")

asyncio.run(main())

Parameters

api_key: API key for Scavio. Defaults to the SCAVIO_API_KEY environment variable.
top_k: Maximum number of results to return. Defaults to 10.
search_params: Additional parameters passed to the Scavio Google search endpoint. Supported keys include country_code, language, page, search_type, device, nfpr, light_request.

License

scavio-haystack is distributed under the terms of the Apache-2.0 license.