Get wines’ information by a vintage year. If you have a vintage year and you want to have all information about its wines, you can use this function to get it.
By default all informations are included. You can add <FILTERS> to the request to limit the informations you want to get so you save request time.
Request
https://api.vincod.com/3/json/wine/GetWinesByVintageYear/fr/<VINTAGEYEAR>?apiKey=<YOURAPIKEY>&Fields=0&Recipes=0&GrapesVarieties=0&Shops=0&Reviews=0&Products=0&Skus=0&Medias=0Parameters
Format : json or xml
Target : wine
Method : GetWinesByVintageYear
LANGUAGE : fr, en, es, de, jp, cn, ru, … < titles are automatically translated, if producer hasn’t supplied contents translation it will be returned in default language (fr or en if the latest exists)
VINTAGEYEAR : year of vintage
FILTERS : GrapesVarieties, Fields, Recipes, Shops, Reviews, Products, Skus, Medias < set to 0 or 1 to exclude or include < by default all included
Sample
Success
https://api.vincod.com/3/json/wine/GetWinesByVintageYear/fr/2011?apiKey=#&Fields=0&Recipes=0&GrapesVarieties=0&Shops=0&Reviews=0&Products=0&Skus=0&Medias=0{
"wines": {
"wine": [
{
"vincod": "IJWE0E",
"name": "Saumur Blanc \"Millésime\"",
"name_standard": "Icon Collection, Blanc, AOP Saumur, Blanc, 2011",
"ownername": "ALLIANCE LOIRE",
"familyname": "Loire Wine Expression",
"wineryname": "Icon Collection",
"rangename": "Blanc",
"more": "",
"appellation": "AOP Saumur",
"climat_revendique": "",
"climat_revendique_signification": "",
"chablis_premier_cru_climat_origine": "",
"wine_sourcing": "",
"classement": "",
"region": "Vallée de la Loire et Centre",
"subregion": "",
"country": "France",
"winecategory": "Vin Tranquille",
"winetype": "Blanc",
"winetypecolor": "Blanc",
"vintageyear": "2011",
"abstract": "",
"picture": "https://cdn.vin.co/_clients_folder/allianceloire/_saumur_blanc_millesime_2011_png_20904_retina.png",
"tag": "",
"backlabel": "",
"cover": "",
"banner": "",
"dateupdate": "1594375354",
"vincodperso": "",
"language_abrv": "en",
"wineid": "11383",
"wineryid": "5338",
"parentid": "5338G44AZ3",
"familyvincod": "135F3RON65",
"wineryvincod": "5329D441HD",
"rangevincod": "5338G44AZ3",
"idfiche": "33788",
"id": "19296"
},
{
"vincod": "ESZ1EF",
"name": "Saumur Champigny Rouge Millésime 2011",
"name_standard": "Millésime, AOP Saumur-Champigny, Rouge, 2011",
"ownername": "ALLIANCE LOIRE",
"familyname": "Marché traditionnel",
"wineryname": "Millésime",
"rangename": "",
"more": "",
"appellation": "AOP Saumur-Champigny",
"climat_revendique": "",
"climat_revendique_signification": "",
"chablis_premier_cru_climat_origine": "",
"wine_sourcing": "",
"classement": "",
"region": "Vallée de la Loire et Centre",
"subregion": "",
"country": "France",
"winecategory": "Vin Tranquille",
"winetype": "Rouge",
"winetypecolor": "Rouge",
"vintageyear": "2011",
"abstract": "L’expression du millésime autour d’une cuvée prestigieuse.",
"picture": "",
"tag": "",
"backlabel": "",
"cover": "",
"banner": "",
"dateupdate": "1521645648",
"vincodperso": "",
"language_abrv": "fr",
"wineid": "11302",
"wineryid": "5403",
"parentid": "5403D46335",
"familyvincod": "136F3SKPCH",
"wineryvincod": "5403D46335",
"rangevincod": "",
"idfiche": "33609",
"id": "19153"
}
]
}
}Error
{
"wines": {
"error": "No wine founds"
}
}