Skip to main content
POST
Search Clips

POST /api/v1/search/query

Search for video clips using natural language queries. Returns relevant clips with timestamps, relevance scores, and transcript snippets.

Parameters

Response

Result Object

Example Request

Example Response

Notes

  • Queries can be natural language (e.g., “moments where the crowd goes wild”)
  • Results are ranked by relevance score
  • Each clip includes a transcript snippet for context
  • Clip URLs are valid for 24 hours

Body

application/json
index_id
string
required

ID of the index to search

Example:

"idx_abc123xyz"

query
string
required

Natural language search query

Example:

"touchdown celebrations"

limit
integer
default:10

Maximum number of results to return

Example:

10

Response

Search completed successfully

results
object[]
required

Array of matching clips