Get 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 all the 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/GetWineByVincod/<LANGUAGE>/<VINCOD>?<FILTERS>&apiKey=<YOURAPIKEY>
Parameters
Format : json or xml
Target : wine
Method : GetWineByVincod
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
- Medias
Followings can be added (not included by default)
- Certifications
- Nutritions
Sample default request
https://api.vincod.com/3/json/wine/GetWineByVincod/fr/8YUIGF?apiKey=#
{
"wines": {
"wine": [
{
"vincod": "8YUIGF",
"name": "L'Héritage de Carillan Agir, IGP Pays d'Oc, Cinsault, Grenache, Rosé, BIB 10L",
"name_standard": "L'Héritage de Carillan Agir, Cinsault et Grenache, IGP Pays d'Oc, Rosé",
"ownername": "Maison Johanès Boubée",
"familyname": "Marques MJB",
"wineryname": "L'Héritage de Carillan Agir",
"rangename": "",
"wine_sourcing": "",
"wine_sourcing_id": "",
"more": "Cinsault et Grenache",
"origin_product": "IGP Pays d'Oc, France",
"appellation": "IGP Pays d'Oc",
"classement": "",
"climat_revendique": "",
"climat_revendique_signification": "",
"chablis_premier_cru_climat_origine": "",
"region": "",
"subregion": "",
"country": "France",
"productfamilyslug": "vin",
"productfamily": "Vin",
"winecategory": "Vin Tranquille",
"winetype": "Rosé",
"winetypecolor": "Rosé",
"vintageyear": "",
"aging": "",
"abstract": "L'Héritage de Carillan a sélectionné pour vous une palette de vins de pays de\nFrance riche et variée. Fruit du travail de nos experts, découvrez au travers de\nnotre gamme, des vins typés aux arômes uniques.\nC'est au cœur du plus vieux vignoble de France (VIe siècle avant JC) que se trouvent les vins de pays d'OC. Ouvert sur la mer Méditerranée, il s'étend le long du Golfe du Lion, de Nîmes en passant par la Camargue, jusqu'à la frontière espagnole.",
"picture": "https://cdn.vin.co/_clients_folder/maisonjohanesboubee/3245415350075_1_10L_BIB_IGP_PAYS_D_OC_RSE_CINSAULT_GRENACHE_HDC_NM_AGIR_1628083049_retina.jpg",
"tag": "",
"backlabel": "",
"cover": "",
"banner": "",
"cartography": "",
"squareformat": "",
"dateupdate": "1628083001",
"vincodperso": "",
"language_abrv": "fr",
"wineid": "14052",
"ownerid": "1847",
"familyvincod": "125F3H9HE9",
"wineryid": "10676",
"wineryvincod": "10676D88KA",
"parentid": "10676D88KA",
"rangevincod": "",
"idfiche": "39571",
"id": "23650",
"url_vinco": "vins.maisonjohanesboubee.fr",
"ndd_shortlink": "qr.vin.co",
"grapesvarieties": {
"variety": [
{
"name": "Cinsault",
"amount": "0"
},
{
"name": "Grenache",
"amount": "0"
}
]
},
"recipes": "",
"shops": "",
"reviews": "",
"products": "",
"medias": {
"media": [
{
"name": "3245415350075 10L BIB IGP PAYS D OC RSE CINSAULT GRENACHE HDC AGIR",
"type": "jpg",
"zone": "0",
"ordre": "1",
"url": "https://cdn.vin.co/_clients_folder/maisonjohanesboubee/3245415350075_1_10L_BIB_IGP_PAYS_D_OC_RSE_CINSAULT_GRENACHE_HDC_NM_AGIR_1628083049.jpg",
"url_mini": "https://cdn.vin.co/_clients_folder/maisonjohanesboubee/3245415350075_1_10L_BIB_IGP_PAYS_D_OC_RSE_CINSAULT_GRENACHE_HDC_NM_AGIR_1628083049_mini.jpg",
"url_320": "https://cdn.vin.co/_clients_folder/maisonjohanesboubee/3245415350075_1_10L_BIB_IGP_PAYS_D_OC_RSE_CINSAULT_GRENACHE_HDC_NM_AGIR_1628083049_320.jpg",
"url_640": "https://cdn.vin.co/_clients_folder/maisonjohanesboubee/3245415350075_1_10L_BIB_IGP_PAYS_D_OC_RSE_CINSAULT_GRENACHE_HDC_NM_AGIR_1628083049_640.jpg",
"url_1024": "https://cdn.vin.co/_clients_folder/maisonjohanesboubee/3245415350075_1_10L_BIB_IGP_PAYS_D_OC_RSE_CINSAULT_GRENACHE_HDC_NM_AGIR_1628083049_1024.jpg",
"url_retina": "https://cdn.vin.co/_clients_folder/maisonjohanesboubee/3245415350075_1_10L_BIB_IGP_PAYS_D_OC_RSE_CINSAULT_GRENACHE_HDC_NM_AGIR_1628083049_retina.jpg",
"preview": "https://cdn.vin.co/_clients_folder/maisonjohanesboubee/3245415350075_1_10L_BIB_IGP_PAYS_D_OC_RSE_CINSAULT_GRENACHE_HDC_NM_AGIR_1628083049_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": "Âge moyen des vignes",
"value": "",
"slug": "specifications-vines-age",
"unit": "ans"
},
{
"label": "Élevage en cuve",
"value": "",
"slug": "specifications-aging-vats",
"unit": "mois"
},
{
"label": "Élevage en fût",
"value": "",
"slug": "specifications-aging-barrels",
"unit": "mois"
},
{
"label": "Élevage 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 free",
"value": "",
"slug": "specifications-so2-free",
"unit": "mg/L"
},
{
"label": "SO2 total",
"value": "",
"slug": "specifications-so2-total",
"unit": "mg/L"
}
],
"advice": [
{
"label": "Service",
"value": "Servir entre 8° et 10°C.",
"slug": "advice-service"
},
{
"label": "Potentiel de garde",
"value": "A boire dans l'année.",
"slug": "advice-cellaring"
},
{
"label": "Dégustation",
"value": "Le vin présente un robe pâle délicatement saumonée.\u003Cbr /\u003E\nL'assemblage des deux cépages Cinsault et Grenache, donne un rosé fruité agréable et délicat, marqué par des notes de petits fruits rouges frais comme la fraise des bois ou la framboise.\u003Cbr /\u003E\nEn bouche, ce vin garde de la fraîcheur avec une finale gouleyante.",
"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": "Plaisir facile : A boire très frais en apéritif lors d'une fin de journée estivale.\u003Cbr /\u003E\nInstant cuisine : Accompagnera un Tex-Mex mexicain bien épicé.\u003Cbr /\u003E\nEntre amis : Délicieux sur une salade niçoise fraîchement préparée.",
"slug": "advice-pairing"
},
{
"label": "Accords Mets-Vins classiques",
"value": "",
"slug": "advice-pairing-listing"
},
{
"label": "Citations",
"value": "",
"slug": "advice-press"
}
],
"presentation": [
{
"label": "Présentation",
"value": "Agir pour une viticulture responsable : les vignerons s'engagent à nos côtés pour la\u003Cbr /\u003E\npréservation du paysage viticole français. Ce vin est issu d'un vignoble qui participe à la préservation des terres pour les générations futures. Les vignerons s'inscrivent dans une démarche environnementale labellisée.",
"slug": "presentation-the-wine"
},
{
"label": "Vidéo de Présentation",
"value": "",
"slug": "video-presentation"
},
{
"label": "Le millésime",
"value": "",
"slug": "presentation-vintage-year"
},
{
"label": "Situation",
"value": "",
"slug": "presentation-situation"
},
{
"label": "Terroir",
"value": "",
"slug": "presentation-terroir"
},
{
"label": "À la vigne",
"value": "Cet assemblage apporte le meilleur de chacun des deux cépages. Le grenache, cépage venu d'Espagne, est connu pour son caractère fruité et sa concentration. Le cinsault, un cépage classique des grands vins rosés, apporte de la délicatesse et de la légèreté.",
"slug": "presentation-vineyard"
},
{
"label": "Vendanges",
"value": "",
"slug": "presentation-harvest-starts"
},
{
"label": "Assemblage",
"value": "",
"slug": "presentation-blending"
},
{
"label": "Vinification",
"value": "",
"slug": "presentation-vinification"
},
{
"label": "Élevage",
"value": "",
"slug": "presentation-maturation"
}
],
"specifications": [
{
"label": "Teneur en alcool",
"value": "",
"slug": "specifications-tav",
"unit": "% vol."
},
{
"label": "Teneur en sucre",
"value": "",
"slug": "specifications-tes",
"unit": "g/L"
},
{
"label": "À consommer de préférence avant le",
"value": "",
"slug": "specifications-ddm"
},
{
"label": "Délai de consommation après ouverture",
"value": "",
"slug": "specifications-consumption-after-opening"
},
{
"label": "Allergènes (sulfite)",
"value": "Contient des sulfites",
"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": "Haute Valeur Environnementale",
"slug": "specifications-certifications"
},
{
"label": "Autres labels",
"value": "",
"slug": "specifications-market-certifications"
}
],
"logistique": [
{
"label": "Type de bouteille",
"value": "",
"slug": "logistic-bottle-type"
},
{
"label": "Contenance",
"value": "",
"slug": "logistic-bottle-capacity",
"unit": "ml"
},
{
"label": "Code article",
"value": "",
"slug": "logistic-product-sku"
},
{
"label": "Barcode bouteille",
"value": "3245415350075",
"slug": "logistic-bottle-upc"
},
{
"label": "Barcode Carton",
"value": "",
"slug": "logistic-case-upc"
},
{
"label": "Cols par carton",
"value": "",
"slug": "logistic-unit-per-case"
},
{
"label": "Cols par palette",
"value": "",
"slug": "logistic-unit-pallet"
},
{
"label": "Rangs par palette",
"value": "",
"slug": "logistic-layers-per-pallet"
},
{
"label": "Cartons par rang",
"value": "",
"slug": "logistic-cases-per-layer"
},
{
"label": "Poids btlle",
"value": "",
"slug": "logistic-unit-weight",
"unit": "kg"
},
{
"label": "Poids carton",
"value": "",
"slug": "logistic-case-weight",
"unit": "kg"
},
{
"label": "Poids palette",
"value": "",
"slug": "logistic-pallet-weight",
"unit": "kg"
},
{
"label": "Hauteur btlle",
"value": "",
"slug": "logistic-bottle-height",
"unit": "cm"
},
{
"label": "Diamètre btlle",
"value": "",
"slug": "logistic-bottle-diameter",
"unit": "cm"
},
{
"label": "Dimensions cartons",
"value": "",
"slug": "logistic-case-dimensions",
"unit": "H*L*P cm"
},
{
"label": "Dimensions palette",
"value": "",
"slug": "logistic-pallet-dimensions",
"unit": "H*L*P cm"
},
{
"label": "Barcode pack",
"value": "",
"slug": "logistic-pack-upc"
},
{
"label": "Cols par pack",
"value": "",
"slug": "logistic-unit-per-pack"
}
]
},
"skus": {
"sku": [
{
"name": "L'Héritage de Carillan, Cinsault et Grenache, IGP Pays d'Oc, Rosé, BIB 10L",
"conditioning": "Bag-in-Box (10 L)",
"capacity": "10000",
"itemcode": "",
"barcode": "3245415350075",
"barcodetype": "ean13",
"closure_type": "Non défini",
"quantity": "0",
"packing": "",
"sorting_info_marking": ""
}
]
}
}
]
}
}
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":"8YUIGF",
"name":"L'H\u00e9ritage de Carillan, Cinsault et Grenache, IGP Pays d'Oc, Ros\u00e9, BIB 10L",
"name_standard":"L'H\u00e9ritage de Carillan, Cinsault et Grenache, IGP Pays d'Oc, Ros\u00e9, 0",
"ownername":"Maison Johan\u00e8s Boub\u00e9e",
"wineryname":"L'H\u00e9ritage de Carillan",
"rangename":"",
"more":"Cinsault et Grenache",
"appellation":"IGP Pays d'Oc",
"region":"Languedoc-Roussillon",
"subregion":"",
"country":"France",
"winecategory":"Vin Tranquille",
"winetype":"Ros\u00e9",
"winetypecolor":"Ros\u00e9",
"vintageyear":"",
"abstract":"Aromatique, fruit\u00e9 et gourmand, c'est un vrai vin plaisir.",
"picture":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_1_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24303_640.jpg",
"tag":"",
"backlabel":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_haut_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24304_640.jpg",
"cover":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_2_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24305_640.jpg",
"dateupdate":"1534146063",
"climat_revendique":"",
"climat_revendique_signification":"",
"chablis_premier_cru_climat_origine":"",
"vincodperso":"",
"wineid":"14052",
"wineryid":"4419",
"parentid":"4419D3ERH9",
"wineryvincod":"4419D3ERH9",
"rangevincod":"",
"idfiche":"39571",
"id":"23650"
}
]
}
}
Sample filtered request for Nutrition only
https://api.vincod.com/3/json/wine/GetWineByVincod/fr/21B9EF?GrapesVarieties=0&Fields=0&Skus=0&Recipes=0&Shops=0&Reviews=0&Products=0&Medias=0&Nutritions=1&apiKey=#
{
"wines": {
"wine": [
{
"vincod": "21B9EF",
"name": "La Vieille Ferme Blanc - 2021",
"name_standard": "La Vieille Ferme, Vin de France, Blanc, 2021",
"ownername": "Famille Perrin",
"familyname": "",
"wineryname": "La Vieille Ferme",
"rangename": "",
"wine_sourcing": "",
"wine_sourcing_id": "",
"more": "",
"origin_product": "Vin de France, VSIG, France",
"appellation": "Vin de France",
"classement": "",
"climat_revendique": "",
"climat_revendique_signification": "",
"chablis_premier_cru_climat_origine": "",
"region": "VSIG",
"subregion": "",
"country": "France",
"productfamilyslug": "vin",
"productfamily": "Vin",
"winecategory": "Vin Tranquille",
"winetype": "Blanc",
"winetypecolor": "Blanc",
"vintageyear": "2021",
"aging": "",
"abstract": "Si vous aimez les vins blancs de plaisir, c'est le vin idéal à l'apéritif ou sur une cuisine simple.",
"picture": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Blanc_2021_1670501774_retina.png",
"tag": "https://cdn.vin.co/_clients_folder/perrin/La_Vieille_Ferme_Blanc_2021_Macro_1623334713_retina.jpg",
"backlabel": "",
"cover": "",
"banner": "",
"cartography": "",
"squareformat": "",
"dateupdate": "1673945598",
"vincodperso": "",
"language_abrv": "fr",
"wineid": "4679",
"ownerid": "12",
"familyvincod": "",
"wineryid": "12",
"wineryvincod": "12DC5HXR3N",
"parentid": "12DC5HXR3N",
"rangevincod": "",
"idfiche": "76465",
"id": "49658",
"url_vinco": "m.familleperrin.com",
"ndd_shortlink": "qr.vin.co",
"nutritions": {
"nutrition": [
{
"nutrition_id": "63356db01f2a3",
"label": "Déclaration nutritionnelle Europe",
"url": "https://qr.vin.co/uq5vsO",
"internal_id": "",
"batch_number": "",
"tav": "0,0",
"conditioning_label": "",
"conditioning_capacity": "",
"serving_label": "",
"serving_capacity": "",
"ingredients": "Raisin, conservateurs (sulfites)",
"nutrition_values": {
"nutrition_value": [
{
"label": "Energie - Joules",
"value": "293",
"slug": "energy-kj",
"unit": "kJ/100ml"
},
{
"label": "Energie - Calories",
"value": "70",
"slug": "energy-kcal",
"unit": "kcal/100ml"
},
{
"label": "Matières grasses",
"value": "0.00",
"slug": "fat",
"unit": "g/100ml"
},
{
"label": " dont acides gras saturés",
"value": "0.00",
"slug": "fat-saturates",
"unit": "g/100ml"
},
{
"label": "Glucides",
"value": "0,05",
"slug": "carbohydrate",
"unit": "g/100ml"
},
{
"label": " dont sucres",
"value": "0,05",
"slug": "carbohydrate-sugar",
"unit": "g/100ml"
},
{
"label": "Protéines",
"value": "0,13",
"slug": "protein",
"unit": "g/100ml"
},
{
"label": "Sel",
"value": "0.00",
"slug": "salt",
"unit": "g/100ml"
}
]
}
}
]
}
}
]
}
}
Errors
{
"wines": {
"wine": [
{
"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.