Sign in

v1

latestOpenAPI 3.1.02026-07-266827131.9 KB

Video Searching Agent (SSE Stream)

Search and analyze videos across YouTube, TikTok, Instagram, and X/Twitter using an agentic Gemini loop. Returns results as Server-Sent Events (SSE).

post/queries/stream

Request body

querystring required

Natural-language search query

platformsstring[]

Restrict to specific platforms. If omitted, all platforms are searched.

max_resultsinteger

Maximum number of video results to return

time_frame'past_24h' | 'past_week' | 'past_month' | 'past_year'

Recency filter for video results

max_stepsinteger

Maximum agent iteration steps

enable_clarificationboolean

When true, the agent may return a clarification event instead of searching if the query is ambiguous

Example request

{
  "query": "Find trending AI coding tool videos on TikTok from the past week"
}

Response

SSE stream of agent events (started → progress → tool_call → tool_result → complete)

session_idstring

Unique session identifier

querystring

Original user query

answerstring

Natural-language answer summarizing findings

platforms_searchedstring[]
total_videos_analyzedinteger
total_creators_analyzedinteger
confidence_scorenumber
data_freshnessstring
steps_takeninteger
tools_usedstring[]
execution_time_secondsnumber