Get a video by ID | NaviSavi Commercial API

import requests
url = "https://api.navisavitravel.com/v1/videos/42"
headers = {"x-api-key": "<apiKey>"}
response = requests.get(url, headers=headers)
print(response.json())

{
  "id": "42",
  "@context": "https://schema.org",
  "@type": "VideoObject",
  "title": "Sunset over the Promenade des Anglais",
  "description": "string",
  "thumbnailUrl": "string",
  "uploadDate": "2024-01-15T09:30:00Z",
  "duration": 1.1,
  "contentUrl": "string",
  "embedUrl": "string",
  "publisher": {
    "@type": "string",
    "name": "string",
    "url": "string"
  },
  "creator": {
    "@type": "string",
    "name": "string"
  },
  "location": {
    "@type": "string",
    "name": "string",
    "address": {
      "addressLocality": "string",
      "addressRegion": "string",
      "addressCountry": "string",
      "addressFullName": "string"
    },
    "geo": {
      "@type": "string",
      "latitude": 1.1,
      "longitude": 1.1
    }
  },
  "keywords": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "metadata": {
    "bestTimeToVisit": "string",
    "experienceType": [
      "string"
    ],
    "suitability": [
      "string"
    ],
    "recommendedVisitDuration": "string",
    "accessibilityNotes": "string",
    "gearRecommendations": [
      "string"
    ],
    "tone": "string",
    "style": "string",
    "sentiment": "string",
    "callToAction": "string"
  },
  "experienceProfile": {
    "relaxingToAdventurous": 1.1,
    "intimateToSocial": 1.1,
    "localToBranded": 1.1,
    "natureToUrban": 1.1,
    "quietToLively": 1.1,
    "classicToTrendy": 1.1,
    "enrichingToIndulgent": 1.1,
    "iconicToHiddenGem": 1.1,
    "photogenicToFunctional": 1.1
  },
  "vibes": [
    "string"
  ],
  "conversationalQueries": {
    "en": [
      "string"
    ],
    "es": [
      "string"
    ],
    "zh": [
      "string"
    ]
  },
  "timestampContext": {
    "dayOfWeek": "string",
    "month": "string",
    "season": "string",
    "timeOfDay": "string",
    "weather": "string"
  },
  "nearestAirport": {
    "text": "string",
    "name": "string",
    "location": "string",
    "airportCode": "string",
    "flightsUrl": "string"
  },
  "nearbyAccommodation": {
    "staysUrl": "string",
    "text": "string"
  },
  "nearbyExperiences": {
    "experiencesUrl": "string",
    "text": "string"
  },
  "assetId": "string",
  "streamUrl": "string",
  "resolutions": {
    "270p": "string",
    "360p": "string",
    "480p": "string",
    "540p": "string",
    "720p": "string",
    "1080p": "string",
    "1440p": "string",
    "2160p": "string"
  },
  "playerUrl": "string",
  "playbackId": "string",
  "clipUrl": "string",
  "thumbnails": {
    "jpeg": "string",
    "png": "string",
    "webp": "string"
  }
}

Returns a single video by its ID.

Authentication

x-api-keystring

API key issued with your NaviSavi plan

Path parameters

videoIdstringRequired

Query parameters

thumbnailWidthintegerOptional>=1Defaults to 1280

Thumbnail width in pixels

thumbnailHeightintegerOptional>=1Defaults to 720

Thumbnail height in pixels

thumbnailTimedoubleOptional>=0Defaults to 4

Time offset in seconds for thumbnail frame (clamped to video duration, or 30s if unknown)

thumbnailTypeenumOptionalDefaults to png

Thumbnail image format

Allowed values:

minResolutionenumOptional

Minimum video resolution for contentUrl. Must be provided together with maxResolution.

maxResolutionenumOptional

Maximum video resolution for contentUrl. Must be provided together with minResolution.

Response

Video details

idstring

@contextstring

@typestring

titlestring

descriptionstring

thumbnailUrlstring

uploadDatedatetime

durationdouble or null

contentUrlstring

embedUrlstring

publisherobject

creatorobject

locationobject

keywordslist of strings or null

tagslist of strings or null

metadataobject

experienceProfileobject

vibeslist of strings

conversationalQueriesobject or null

timestampContextobject

nearestAirportobject

nearbyAccommodationobject

nearbyExperiencesobject

assetIdstring

streamUrlstring

resolutionsobject

playerUrlstring

playbackIdstring

clipUrlstring or null

thumbnailsobject

Authentication

Path parameters

Query parameters

Response

Errors