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

pageintegerOptional>=1Defaults to 1

Page number (1-based)

limitintegerOptional1-100Defaults to 20

Results per page (max 100)

qstringRequired1-200 characters

Natural language search query (maximum 200 characters)

Response

Search results with derived filters
querystring
The original query string
filtersmap from strings to any
Structured filters derived from the query by ATLAS
datalist of objects
metaobject

Errors

400
Bad Request Error
403
Forbidden Error
500
Internal Server Error