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.
Set includeCoordinates=true to also receive a coordinates array of up to 500 map points for the full result set of the query, for rendering a map alongside the results.
Authentication
Query parameters
Page number (1-based)
Results per page (max 100)
Natural language search query (maximum 200 characters)
When true, include a coordinates array of up to 500 lightweight map points covering the entire result set of the query (not just the current page), suitable for rendering alongside the results. Off by default.
Time offset in seconds for thumbnail frame (clamped to video duration, or 30s if unknown)
Response
Map points for the entire filtered result set (not just the current page), capped at 500. Present only when includeCoordinates=true. Independent of pagination, so request it once (e.g. on page 1) and reuse it while paging the same query.

