Integration

OpenAI Assistants + Google

Search Google from your OpenAI Assistants agent with Scavio. Get organic results, knowledge graph, People Also Ask in structured JSON.

What is OpenAI Assistants?

OpenAI's API for building AI assistants with function calling, code interpreter, and file search capabilities.

Searching Google with OpenAI Assistants

This integration lets your OpenAI Assistants agent search Google in real time via the Scavio API. The agent gets back structured JSON with organic results, knowledge graph, People Also Ask, AI overview — ready for reasoning and decision-making.

Setup

Bash
pip install openai requests

Code Example

Here is a complete OpenAI Assistants agent that searches Google using Scavio:

Python
from openai import OpenAI
import requests
import json

client = OpenAI()

def scavio_search(query: str) -> str:
    response = requests.post(
        "https://api.scavio.dev/api/v1/search",
        headers={"x-api-key": "your_scavio_api_key", "Content-Type": "application/json"},
        json={"query": query},
    )
    return json.dumps(response.json())

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "best noise cancelling headphones 2026"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "scavio_search",
            "description": "Search Google for real-time results",
            "parameters": {
                "type": "object",
                "properties": {"query": {"type": "string"}},
                "required": ["query"],
            },
        },
    }],
)

# Handle tool calls
for tool_call in response.choices[0].message.tool_calls or []:
    result = scavio_search(json.loads(tool_call.function.arguments)["query"])
    print(result[:500])

Full Working Example

A production-ready example with error handling:

Python
from openai import OpenAI
import requests
import json

client = OpenAI()

def scavio_search(query: str) -> str:
    response = requests.post(
        "https://api.scavio.dev/api/v1/search",
        headers={"x-api-key": "your_scavio_api_key", "Content-Type": "application/json"},
        json={"query": query},
    )
    return json.dumps(response.json())

tools = [{
    "type": "function",
    "function": {
        "name": "scavio_search",
        "description": "Search Google for real-time results",
        "parameters": {
            "type": "object",
            "properties": {"query": {"type": "string"}},
            "required": ["query"],
        },
    },
}]

messages = [{"role": "user", "content": "best noise cancelling headphones 2026"}]
response = client.chat.completions.create(model="gpt-4o", messages=messages, tools=tools)

if response.choices[0].message.tool_calls:
    messages.append(response.choices[0].message)
    for tc in response.choices[0].message.tool_calls:
        result = scavio_search(json.loads(tc.function.arguments)["query"])
        messages.append({"role": "tool", "tool_call_id": tc.id, "content": result})
    final = client.chat.completions.create(model="gpt-4o", messages=messages)
    print(final.choices[0].message.content)

Pricing

Scavio offers a free tier with 500 credits/month (1 credit per search). No credit card required. This is enough to build and test your OpenAI Assistants integration. Paid plans start at $30/month for higher volumes.

Frequently Asked Questions

Install Scavio and create a OpenAI Assistants tool that calls the Scavio API. Register the tool with your agent and your OpenAI Assistants agent will have access to real-time search across Google, Amazon, YouTube, and Walmart.

Scavio works with OpenAI Assistants via custom tool definitions. The integration takes under 10 minutes to set up. See the code example above for the full setup.

Once connected, your OpenAI Assistants agent can search Google (web, news, images, shopping, maps), Amazon (12 marketplaces), YouTube (videos, transcripts, channels), and Walmart. All from a single API key.

Scavio has a free tier with 500 credits/month (1 credit per search). This is enough to build and test your OpenAI Assistants integration. Paid plans start at $30/month. There is no per-seat or per-agent pricing.

Yes. The Scavio API returns live Google results with organic results, knowledge graph, People Also Ask in structured JSON. Your OpenAI Assistants agent can use this data to make informed decisions based on current information.

Add Real-Time Search to OpenAI Assistants

Get your free Scavio API key and connect OpenAI Assistants to Google, Amazon, YouTube, Walmart, and Reddit. 500 free credits/month.