Season × country summary

GET

/v1/seasons/:seasonName/countries/:countryId/summary

GET

/v1/seasons/:seasonName/countries/:countryId/summary

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

1 {
2   "season": "Summer",
3   "countryId": 1,
4   "countryName": "France",
5   "countryIsoCode": "FR",
6   "breadcrumbList": [
7     "Summer",
8     "France"
9   ],
10   "description": "France during Summer carries a Beach getaway feel, especially around its restaurant scene, captured across the country's most-filmed regions.",
11   "editorial": null,
12   "topRegions": [
13     {
14       "id": 12,
15       "name": "Corsica"
16     }
17   ],
18   "topLocalities": [
19     {
20       "id": 55,
21       "name": "Paris"
22     }
23   ],
24   "topVibes": [
25     {
26       "id": 9,
27       "name": "Beach getaway"
28     }
29   ],
30   "topPlaceCategories": [
31     {
32       "slug": "restaurant",
33       "name": "Restaurant"
34     }
35   ],
36   "locationCount": 210,
37   "regionCount": 12,
38   "relatedCollections": {
39     "sameSeasonOtherCountries": [
40       {
41         "slug": "Summer/2-italy",
42         "country": "Italy"
43       }
44     ],
45     "sameCountryOtherSeasons": [
46       {
47         "slug": "Winter/1-france",
48         "name": "Winter"
49       }
50     ]
51   }
52 }

Returns a cross-dimensional summary for a specific season within a country. Includes top regions, localities, vibes, place categories, and an SEO-ready description. The season name is case-insensitive and may contain spaces, e.g. Dry Season.

Authentication

x-api-keystring

API key issued with your NaviSavi plan

Path parameters

seasonNamestringRequired

countryIdintegerOptional

Response

Season and country summary

seasonstring

countryIdinteger

countryNamestring or null

countryIsoCodestring or null

breadcrumbListlist of strings

descriptionstring

editorialobject or null

topRegionslist of objects

topLocalitieslist of objects

topVibeslist of objects

topPlaceCategorieslist of objects

locationCountinteger

regionCountinteger

relatedCollectionsobject

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error