Integration

OpenAI Assistants + YouTube

Search YouTube from your OpenAI Assistants agent with Scavio. Get video results, channel results, playlist results in structured JSON.

What is OpenAI Assistants?

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

Searching YouTube with OpenAI Assistants

This integration lets your OpenAI Assistants agent search YouTube in real time via the Scavio API. The agent gets back structured JSON with video results, channel results, playlist results, transcripts — ready for reasoning and decision-making.

Setup

Bash
pip install openai requests

Code Example

Here is a complete OpenAI Assistants agent that searches YouTube 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/youtube/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": "python web scraping tutorial"}],
    tools=[{
        "type": "function",
        "function": {
            "name": "scavio_search",
            "description": "Search YouTube 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/youtube/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 YouTube for real-time results",
        "parameters": {
            "type": "object",
            "properties": {"query": {"type": "string"}},
            "required": ["query"],
        },
    },
}]

messages = [{"role": "user", "content": "python web scraping tutorial"}]
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 YouTube results with video results, channel results, playlist results 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.