List and search videos
Returns a paginated list of videos. Supports rich filtering across experience categories, audience segments, vibes, 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.
experienceCategories
Filter by one or more experience categories
audienceSegments
Filter by one or more audience segments
vibes
Filter by one or more vibes in the format “{vibe_category} > {vibe}”, e.g. “Personal & Intimate > Solo travel”
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
locations
Filter by one or more location names
destinations
Filter by one or more destination slugs
minDuration
Minimum video duration in seconds
maxDuration
Maximum video duration in seconds
month
Filter by month name
season
timeOfDay
Case-insensitive match
Response
Paginated list of videos
data
meta
Errors
400
Bad Request Error
403
Forbidden Error
500
Internal Server Error
