Get Started

Introduction

The NaviSavi Commercial API gives travel companies programmatic access to NaviSavi’s library of authentic travel videos. Use it to search, filter, and embed videos on your website or application, or to license footage for advertising, marketing, and other promotional materials.

What you can do

  • Browse geography - explore our video library by country, region, locality, and specific location
  • Get destination detail pages - fetch rich detail for any country, region, locality, or location, including a hero image, top seasons, experience categories, vibes, audience segments, and an SEO-ready description
  • Browse taxonomy - list and retrieve detail pages for experience categories, audience segments, vibes, and seasons
  • Filter by experience - find videos matching specific experience categories, audience segments, vibes, and keywords
  • Search by time - filter by month, season, or time of day to find videos that match a destination’s best moments
  • Cross-dimensional summaries - query pre-computed summaries for any taxonomy-country combination (e.g. Culture & Heritage in France), useful for building landing pages
  • Search with natural language - describe what you’re looking for in plain English and the API extracts structured filters automatically using an LLM
  • Embed and license - every video response includes stream URLs, embed URLs, and production-quality file links

Base URL

https://api.navisavitravel.com

All endpoints are versioned under /v1.

Pagination

Every list endpoint enforces pagination. Pass page and limit query parameters to control results:

ParameterDefaultMaximum
page1-
limit20100

All list responses include a meta object:

1{
2  "data": [...],
3  "meta": {
4    "page": 1,
5    "limit": 20,
6    "total": 142,
7    "totalPages": 8
8  }
9}

SDKs

Official SDKs are available for TypeScript, Python, and Ruby. See the sidebar for installation and usage instructions.