What is OpenAI Assistants?
OpenAI's API for building AI assistants with function calling, code interpreter, and file search capabilities.
How It Works
Scavio connects to OpenAI Assistants via a custom tool definition. Once connected, your OpenAI Assistants agent can search Google, Amazon, YouTube, and Walmart in real time. Each search returns structured JSON -- no HTML parsing, no scraping infrastructure.
Setup
Bash
pip install openai requestsCode Example
Here is a complete OpenAI Assistants integration with 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": "Find the best noise cancelling headphones"}],
tools=[{
"type": "function",
"function": {
"name": "scavio_search",
"description": "Search the web 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 the web for real-time results",
"parameters": {
"type": "object",
"properties": {"query": {"type": "string"}},
"required": ["query"],
},
},
}]
messages = [{"role": "user", "content": "Find the best noise cancelling headphones"}]
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)Available Platforms
Once connected, your OpenAI Assistants agent has access to all four Scavio platforms:
- Google — Web search with knowledge graph, PAA, and AI overviews
- Amazon — Product search with prices, ratings, and reviews
- Reddit — Community, posts & threaded comments from any subreddit
- YouTube — Video search with transcripts and metadata
- Walmart — Product search with pricing and fulfillment data
- LinkedIn — Post, profile, and company discovery via search
- TikTok — Trending video, creator, and product discovery
- Shopify — Cross-store product discovery and enrichment
- X (Twitter) — Post and profile discovery via search
- Apple App Store — App discovery, ranking, and review data
- Google Play Store — Android app discovery and ranking data
- Google Reviews — Business review extraction with ratings and responses
- Google Scholar — Academic paper search with citation counts
- Google Ads Transparency — Competitor ad creative and transparency data via SERP
- Reddit Comments Tree — Deep threaded comment fetch for brand monitoring
- YouTube Shorts — Shorts-specific search with metadata
- YouTube Playlists — Playlist discovery and removal tracking
- Google Jobs — Live jobs-board search for recruiting
- Amazon Bestsellers — Bestseller rank-change feed across categories
Pricing
Scavio offers a free tier with 50 credits on signup (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.