Video Search

Searches the web for videos from a text query. Contact us to request beta access.

post/video-search

Request

  • Base URL: https://api.octen.ai
  • URL: https://api.octen.ai/video-search
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Request body

countinteger

Number of results to return.

time_range'day' | 'week' | 'month' | 'year' | 'd' | 'w' | 'm' | 'y'

Relative time window counting back from the current time, filtered by publish time. Mutually exclusive with start_time/end_time — if both are provided, start_time/end_time take precedence.

start_timestring date-time

Start time for filtering results by publish time. ISO 8601 format.

end_timestring date-time

End time for filtering results by publish time. ISO 8601 format.

safesearch'off' | 'strict'

Controls filtering of explicit/adult content. off disables filtering; strict drops all adult content.

Example request

{
  "start_time": "2025-01-01T00:00:00+08:00",
  "end_time": "2025-01-01T00:00:00+08:00"
}

Response

Successful video search response

codeinteger

Business status code. 0 indicates success.

msgstring

A message describing the result.

request_idstring

The unique identifier for this request.

Changes

No recorded changes to this operation across all 1 revision of this API.