Skip to main content
POST
Video Search

Authorizations

Authorization
string
header
required

Bearer token used for request authentication. Alternatively, you can send the API key in the x-api-key header. Note: A payment method is required to use the API.

Body

application/json

Request body for the Video Search API.

inputs
object[]
required

Input array carrying a text query (at most 1).

Maximum array length: 1
count
integer
default:5

Number of results to return.

Required range: 1 <= x <= 10
time_range
enum<string>

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.

Available options:
day,
week,
month,
year,
d,
w,
m,
y
start_time
string<date-time>

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

Example:

"2025-01-01T00:00:00+08:00"

end_time
string<date-time>

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

Example:

"2025-01-01T00:00:00+08:00"

safesearch
enum<string>
default:strict

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

Available options:
off,
strict

Response

Successful video search response

request_id
string

The unique identifier for this request.

data
object

The main response payload.

meta
object

Additional metadata for the Video Search request.