List and search videos
Returns a paginated list of videos. Supports rich filtering across experience types, vibes, suitabilities, keywords, tags, geography, and time context. Multiple values for the same filter are combined with OR logic.
Authentication
x-api-keystring
API key issued with your NaviSavi plan
Query parameters
page
Page number (1-based)
limit
Results per page (max 100)
thumbnailWidth
Thumbnail width in pixels
thumbnailHeight
Thumbnail height in pixels
thumbnailTime
Time offset in seconds for thumbnail frame (clamped to video duration, or 30s if unknown)
thumbnailType
Thumbnail image format
Allowed values:
minResolution
Minimum video resolution for contentUrl. Must be provided together with maxResolution.
maxResolution
Maximum video resolution for contentUrl. Must be provided together with minResolution.
experienceTypes
Filter by one or more experience type names
vibes
Filter by one or more vibes in the format “{vibe_category} > {vibe}”, e.g. “Personal & Intimate > Solo travel”
suitabilities
Filter by one or more suitability names
keywords
Filter by one or more keyword names
countries
Filter by one or more country names
regions
Filter by one or more region names
localities
Filter by one or more locality names
minDuration
Minimum video duration in seconds
maxDuration
Maximum video duration in seconds
month
Filter by month name
season
Allowed values:
timeOfDay
Case-insensitive match
Response
Paginated list of videos
data
meta
