ATLAS natural language video search
Search for videos using a natural language query. Pass any descriptive phrase — such as `luxury rooftop hotels in Tokyo` or `sunset beach walks in Greece` — and the endpoint returns matching videos. The response includes a `filters` field showing what was applied, which can be useful for debugging or display.
Requires the `videos.atlas_search` permission.
For simpler keyword or point-of-interest searches, use the `search` parameter on `GET /v1/videos` instead — it requires only the `videos.read` permission.
Authentication
x-api-keystring
API key issued with your NaviSavi plan
Query parameters
page
Page number (1-based)
limit
Results per page (max 100)
q
Natural language search query (maximum 200 characters)
Response
Search results with derived filters
query
The original query string
filters
Structured filters derived from the query by ATLAS
data
meta
Errors
400
Bad Request Error
403
Forbidden Error
500
Internal Server Error

