Quick Start
SDKs coming soon. Our TypeScript, Python, and Ruby SDKs are currently in development. In the meantime, you can use the API directly with any HTTP client.
Get up and running with the NaviSavi SDK in a few minutes.
Installation
Initialise the client
Browse videos
The /v1/videos endpoint is the heart of the API. You can filter by geography, experience type, vibe, suitability, keywords, tags, and time context — combining multiple filters to narrow results precisely.
Find cultural immersion videos in Italy
Filter by vibe and suitability
Vibes are expressed as "{category} > {vibe}" strings. Combine with suitabilities to narrow results further.
Browse geography
Use the geography endpoints to build location pickers or populate filter UIs.
Browse taxonomy
Fetch available filter values to populate dropdowns and faceted search UIs.
Pagination
All list endpoints return a meta object alongside data. Use it to drive pagination controls.

