Get a country | NaviSavi Commercial API

curl https://api.navisavitravel.com/v1/countries/1 \
     -H "x-api-key: <apiKey>"

{
  "id": 1,
  "name": "France",
  "isoCode": "FR",
  "heroImageUrl": "https://cdn.example.com/thumb.png",
  "description": "France draws travellers to destinations like Paris and Nice across regions including Île-de-France and Provence-Alpes-Côte d'Azur. Best visited during Summer, it excels for Culture & Heritage and Nature & Outdoors, with a Romantic atmosphere throughout.",
  "topRegions": [
    {
      "id": 12,
      "name": "Corsica",
      "videoCount": 198
    }
  ],
  "topLocalities": [
    {
      "id": 55,
      "name": "Paris",
      "videoCount": 412
    }
  ],
  "topLocations": [
    {
      "id": 200,
      "name": "Eiffel Tower",
      "videoCount": 87
    }
  ],
  "topSeasons": [
    {
      "name": "Summer"
    }
  ],
  "topExperienceCategories": [
    {
      "id": 1,
      "name": "Culture & Heritage"
    }
  ],
  "topVibes": [
    {
      "id": 9,
      "name": "Romantic"
    }
  ],
  "topAudienceSegments": [
    {
      "id": 1,
      "name": "Couples"
    }
  ],
  "relatedDestinations": [
    {
      "id": 1,
      "name": "French Riviera",
      "slug": "french-riviera",
      "category": "Region"
    }
  ]
}

Returns rich detail for a country including a hero image, top regions, localities, locations, seasons, experience categories, vibes, audience segments, and an SEO-ready description.

Authentication

x-api-keystring

API key issued with your NaviSavi plan

Path parameters

countryIdintegerOptional

Response

Country detail

idinteger

namestring

isoCodestring or null

heroImageUrlstring or null

descriptionstring

topRegionslist of objects

topLocalitieslist of objects

topLocationslist of objects

topSeasonslist of objects

topExperienceCategorieslist of objects

topVibeslist of objects

topAudienceSegmentslist of objects

relatedDestinationslist of objects

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error