Get latest vintage product’s data by its unique id we name VINCOD.
To be used when you have a product’s VINCOD – which varies depending on the vintage and language – and you want to get the latest information in the LANGUAGE of your choice.
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/GetLatestVintageByVincod/<LANGUAGE>/<VINCOD>?<FILTERS>&apiKey=<YOURAPIKEY>
Parameters
Format : json or xml
Target : wine
Method : GetLatestVintageByVincod
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 is the latest exists)
VINCOD : Vincod of the wine
FILTERS : set to 0 or 1 to exclude or include <
By default all followings are included
- GrapesVarieties
- Fields
- Recipes
- Shops
- Reviews
- Products
- Skus
- Nutritions
- Medias
Followings can be added (not included by default
- Certifications
Sample default request
https://api.vincod.com/3/json/wine/GetLatestVintageByVincod/fr/VFR9F?apiKey=#
{
"wines": {
"wine": [
{
"vincod": "G1B22D",
"name": "La Vieille Ferme Ventoux Rouge - 2021",
"name_standard": "La Vieille Ferme, AOC Ventoux, Rouge, 2021",
"ownername": "Famille Perrin",
"familyname": "",
"wineryname": "La Vieille Ferme",
"rangename": "",
"wine_sourcing": "",
"wine_sourcing_id": "",
"more": "",
"origin_product": "AOC Ventoux, Vallée du Rhône, Sud (Méridional), France",
"appellation": "AOC Ventoux",
"classement": "",
"climat_revendique": "",
"climat_revendique_signification": "",
"chablis_premier_cru_climat_origine": "",
"region": "Vallée du Rhône",
"subregion": "Sud (Méridional)",
"country": "France",
"productfamily": "Vin",
"winecategory": "Vin Tranquille",
"winetype": "Rouge",
"winetypecolor": "Rouge",
"vintageyear": "2021",
"aging": "",
"abstract": "Seit 1970 produziert La Vieille Ferme authentische, ehrliche und geschmackvolle Weine, Jahrgang um Jahrgang. In einigen der besten Restaurants und Bars der Welt wird der La Vieille Ferme als einer der Weine mit dem besten Preis-Leistungs-Verhältnis angesehen.",
"picture": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_2021_1623334972_retina.jpg",
"tag": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Rouge_2021_Macro_1623335071_retina.jpg",
"backlabel": "",
"cover": "",
"banner": "",
"dateupdate": "1654586281",
"vincodperso": "",
"language_abrv": "de",
"wineid": "378",
"ownerid": "12",
"familyvincod": "",
"wineryid": "12",
"wineryvincod": "12DC5HXR3N",
"parentid": "12DC5HXR3N",
"rangevincod": "",
"idfiche": "76476",
"id": "49660",
"url_vinco": "m.familleperrin.com",
"grapesvarieties": {
"variety": [
{
"name": "Carignan",
"amount": "0"
},
{
"name": "Cinsault",
"amount": "0"
},
{
"name": "Grenache",
"amount": "0"
},
{
"name": "Syrah",
"amount": "0"
}
]
},
"recipes": {
"recipe": [
{
"name": "La Volaille aux 40 gousses d'ail",
"url": "http://cdn.vin.co/_clients_folder/perrin/perrin_volaillesaux40goussesdaillavieillefermerouge_4274.pdf",
"video": "",
"type": "Plat"
},
{
"name": "La Volaille Marquee au Grill",
"url": "http://cdn.vin.co/_clients_folder/perrin/perrin_lavolaillemarqueeaugrillmieletsaucesojalavieillefermerouge_4964.pdf",
"video": "",
"type": "Plat"
}
]
},
"shops": "",
"reviews": "",
"products": "",
"medias": {
"media": [
{
"name": "La Vieille Ferme Rouge - 2021",
"type": "jpg",
"zone": "0",
"ordre": "1",
"url": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_2021_1623334972.jpg",
"url_mini": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_2021_1623334972_mini.jpg",
"url_320": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_2021_1623334972_320.jpg",
"url_640": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_2021_1623334972_640.jpg",
"url_1024": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_2021_1623334972_1024.jpg",
"url_retina": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_2021_1623334972_retina.jpg",
"preview": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_2021_1623334972_mini.jpg"
},
{
"name": "La Vieille Ferme Rouge 2021 Macro",
"type": "jpg",
"zone": "0",
"ordre": "2",
"url": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Rouge_2021_Macro_1623335071.jpg",
"url_mini": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Rouge_2021_Macro_1623335071_mini.jpg",
"url_320": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Rouge_2021_Macro_1623335071_320.jpg",
"url_640": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Rouge_2021_Macro_1623335071_640.jpg",
"url_1024": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Rouge_2021_Macro_1623335071_1024.jpg",
"url_retina": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Rouge_2021_Macro_1623335071_retina.jpg",
"preview": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Rouge_2021_Macro_1623335071_mini.jpg"
}
]
},
"fields": {
"specificationspro": [
{
"label": "Volume de production",
"value": "",
"slug": "specifications-production-volume"
},
{
"label": "Superficie du vignoble",
"value": "",
"slug": "specifications-vineyard-area",
"unit": "ha"
},
{
"label": "Rendement",
"value": "",
"slug": "specifications-vines-yields",
"unit": "hL/ha"
},
{
"label": "Age moyen des vignes",
"value": "",
"slug": "specifications-vines-age",
"unit": "ans"
},
{
"label": "Elevage en cuve",
"value": "",
"slug": "specifications-aging-vats",
"unit": "mois"
},
{
"label": "Elevage en fût",
"value": "",
"slug": "specifications-aging-barrels",
"unit": "mois"
},
{
"label": "Elevage en amphore",
"value": "",
"slug": "specifications-aging-amphorae",
"unit": "mois"
},
{
"label": "Dosage",
"value": "",
"slug": "specifications-dosage",
"unit": "g/l"
},
{
"label": "Sucre résiduel",
"value": "",
"slug": "specifications-residual-sugar",
"unit": "g/l"
},
{
"label": "pH",
"value": "",
"slug": "specifications-ph"
},
{
"label": "Acidité tartrique",
"value": "",
"slug": "specifications-tartaric-acidity",
"unit": "g/l"
},
{
"label": "Acidité volatile",
"value": "",
"slug": "specifications-volatile-acidity",
"unit": "g/l"
},
{
"label": "Acidité totale",
"value": "",
"slug": "specifications-totale-acidity",
"unit": "g/l"
},
{
"label": "SO2 libre",
"value": "",
"slug": "specifications-so2-free",
"unit": "mg/L"
},
{
"label": "SO2 total",
"value": "",
"slug": "specifications-so2-total",
"unit": "mg/L"
}
],
"advice": [
{
"label": "Service",
"value": "17°C für ein spontanes Essen und zum Vergnügen.
",
"slug": "advice-service"
},
{
"label": "Potentiel de garde",
"value": "",
"slug": "advice-cellaring"
},
{
"label": "Dégustation",
"value": "Von schönem, tiefem Granatrot mit leuchtenden Reflexen. In der Nase öffnet sich der Wein mit verführerischen Noten von Veilchen, Gewürzen und marmeladigen Früchten wie Brombeere und Kirsche. Am Gaumen setzt sich diese Aromenvielfalt fort, wobei der Wein sich sehr rund und trinkfreudig mit weichen Tanninen zeigt, bevor er in einen Abgang mit Aromen von roter Johannisbeere mündet, die diesem kräftigen Wein Frische und eine schöne Ausgewogenheit verleihen.",
"slug": "advice-tasting"
},
{
"label": "Aspect visuel",
"value": "",
"slug": "advice-tasting-look"
},
{
"label": "Au nez",
"value": "",
"slug": "advice-tasting-smell"
},
{
"label": "En bouche",
"value": "",
"slug": "advice-tasting-taste"
},
{
"label": "Vidéo de dégustation",
"value": "",
"slug": "video-tasting"
},
{
"label": "Accords gourmands",
"value": "",
"slug": "advice-pairing"
},
{
"label": "Accords Mets-Vins classiques",
"value": "",
"slug": "advice-pairing-listing"
}
],
"presentation": [
{
"label": "L'histoire",
"value": "Die Familie Perrin, auch Besitzer des berühmten Château de Beaucastel, suchen die am besten geeigneten Terroirs um einen frischen und fruchtigen Wein herzustellen. In einfachen Worten, das ist ein Sprichwörtliches Vergnügen; authentisch, echt und lecker
",
"slug": "presentation-the-wine"
},
{
"label": "Vidéo de Présentation",
"value": "",
"slug": "video-presentation"
},
{
"label": "Le millésime",
"value": "Mit dem 2021er Jahrgang zeichnet sich ein frischerer Jahrgang ab, der denen ähnelt, die wir in den 1980er/1990er Jahren hatten. Es ist auch ein Jahr, das von der Arbeit im Weinberg geprägt war, denn die von Winzern und Mitarbeitern ergriffenen Maßnahmen trugen entscheidend zur Qualität dieses Jahrgangs bei. Das von Wetterunbilden gekennzeichnete Jahr - allem voran das Frostereignis im April und die Regenfälle, die die Weinlese unterbrochen haben - verlangte in der Tat zu jeder Zeit einen großen Einsatz unserer Mitarbeiter in den Weinbergen. Ihre Aufmerksamkeit und ihr Engagement trugen Früchte: Es kündigt sich nun ein vielversprechender, herrlich ausgewogener Jahrgang an, geprägt von großer Frische.",
"slug": "presentation-vintage-year"
},
{
"label": "Situation",
"value": "Die Weinberge liegen an den Hängen des Mont Ventoux. Die Höhenlage bietet Frische, die für einen guten Säuregehalt der Trauben sorgt. Der Wein ist also frisch, fruchtig und ausgewogen.
",
"slug": "presentation-situation"
},
{
"label": "Terroir",
"value": "Dies variiert je nach Höhenlage, besteht aber zum größten Teil aus Ablagerungen aus der Basis des kalkhaltigen Mont Ventoux während der Meere des Tertiär. Rote Mittelmeer Böden gemischt mit Kreideschutt und runden Steinen.
",
"slug": "presentation-terroir"
},
{
"label": "A la vigne",
"value": "",
"slug": "presentation-vineyard"
},
{
"label": "Date de début des vendanges",
"value": "",
"slug": "presentation-harvest-starts"
},
{
"label": "Vinification",
"value": "",
"slug": "presentation-vinification"
},
{
"label": "Elevage",
"value": "Jede Rebsorte wurde getrennt gelesen und vinifiziert, sodass die jeweilige Rebsorte stets die optimale Reife besaß. Der Lesezeitpunkt wurde mithilfe von Reifegradanalysen und Probieren der Trauben ermittelt. Sobald die Trauben im Keller ankamen, wurden sie entrappt und eingemaischt. Die Phenole wurden während der Gärung in Zementtanks durch Überpumpen extrahiert.",
"slug": "presentation-maturation"
}
],
"specifications": [
{
"label": "Teneur en alcool",
"value": "",
"slug": "specifications-tav",
"unit": "% vol."
},
{
"label": "Allergènes (sulfite)",
"value": "",
"slug": "specifications-allergens-sulphites"
},
{
"label": "Allergènes (oeuf)",
"value": "",
"slug": "specifications-allergens-egg"
},
{
"label": "Allergènes (lait)",
"value": "",
"slug": "specifications-allergens-milk"
},
{
"label": "OGM",
"value": "",
"slug": "specifications-ogm"
},
{
"label": "Labels viticoles",
"value": "",
"slug": "specifications-certifications"
},
{
"label": "Autres labels",
"value": "",
"slug": "specifications-market-certifications"
}
]
},
"skus": ""
}
]
}
}
Sample filtered request
https://api.vincod.com/3/json/wine/GetWineByVincod/fr/8YUIGF?GrapesVarieties=0&Fields=0&Skus=0&Recipes=0&Shops=0&Reviews=0&Products=0&Medias=0&apiKey=#
{
"wines": {
"wine": [
{
"vincod": "G1B22D",
"name": "La Vieille Ferme Ventoux Rouge - 2021",
"name_standard": "La Vieille Ferme, AOC Ventoux, Rouge, 2021",
"ownername": "Famille Perrin",
"familyname": "",
"wineryname": "La Vieille Ferme",
"rangename": "",
"wine_sourcing": "",
"wine_sourcing_id": "",
"more": "",
"origin_product": "AOC Ventoux, Vallée du Rhône, Sud (Méridional), France",
"appellation": "AOC Ventoux",
"classement": "",
"climat_revendique": "",
"climat_revendique_signification": "",
"chablis_premier_cru_climat_origine": "",
"region": "Vallée du Rhône",
"subregion": "Sud (Méridional)",
"country": "France",
"productfamily": "Vin",
"winecategory": "Vin Tranquille",
"winetype": "Rouge",
"winetypecolor": "Rouge",
"vintageyear": "2021",
"aging": "",
"abstract": "Seit 1970 produziert La Vieille Ferme authentische, ehrliche und geschmackvolle Weine, Jahrgang um Jahrgang. In einigen der besten Restaurants und Bars der Welt wird der La Vieille Ferme als einer der Weine mit dem besten Preis-Leistungs-Verhältnis angesehen.",
"picture": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_2021_1623334972_retina.jpg",
"tag": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Rouge_2021_Macro_1623335071_retina.jpg",
"backlabel": "",
"cover": "",
"banner": "",
"dateupdate": "1654586281",
"vincodperso": "",
"language_abrv": "de",
"wineid": "378",
"ownerid": "12",
"familyvincod": "",
"wineryid": "12",
"wineryvincod": "12DC5HXR3N",
"parentid": "12DC5HXR3N",
"rangevincod": "",
"idfiche": "76476",
"id": "49660",
"url_vinco": "m.familleperrin.com"
}
]
}
}
Errors
{
"wines": {
"error": "No wine founds"
}
}
No wine has been found. Check if VINCOD is correct or ask support to confirm your APIKey is allowed to access this owner.
{
"wines": {
"error": "Invalid or not provided apikey."
}
}
You’re APIKey does not provide any access. Check if APIKey is correct or ask support to confirm your APIKey’s authorizations.