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\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",
"grapesvarieties":{
"variety":[
{
"name":"Cinsault",
"amount":""
},
{
"name":"Grenache noir",
"amount":""
}
]
},
"recipes":"",
"shops":"",
"reviews":"",
"products":"",
"medias":{
"media":[
{
"name":"3245415350075 COTE 1 10L BIB IGP PAYS D'OC CINSAULT GRENACHE RSE HDC NM 46690",
"type":"jpg",
"zone":"",
"ordre":"1",
"url":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_1_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24303.jpg",
"url_mini":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_1_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24303_mini.jpg",
"url_320":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_1_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24303_320.jpg",
"url_640":"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",
"url_1024":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_1_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24303_1024.jpg",
"url_retina":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_1_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24303_retina.jpg",
"preview":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_1_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24303_mini.jpg"
},
{
"name":"3245415350075 COTE 2 10L BIB IGP PAYS D'OC CINSAULT GRENACHE RSE HDC NM 46690",
"type":"jpg",
"zone":"",
"ordre":"3",
"url":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_2_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24305.jpg",
"url_mini":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_2_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24305_mini.jpg",
"url_320":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_2_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24305_320.jpg",
"url_640":"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",
"url_1024":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_2_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24305_1024.jpg",
"url_retina":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_2_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24305_retina.jpg",
"preview":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_cote_2_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24305_mini.jpg"
},
{
"name":"3245415350075 HAUT 10L BIB IGP PAYS D'OC CINSAULT GRENACHE RSE HDC NM 46690",
"type":"jpg",
"zone":"",
"ordre":"4",
"url":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_haut_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24304.jpg",
"url_mini":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_haut_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24304_mini.jpg",
"url_320":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_haut_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24304_320.jpg",
"url_640":"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",
"url_1024":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_haut_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24304_1024.jpg",
"url_retina":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_haut_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24304_retina.jpg",
"preview":"https:\/\/cdn.vin.co\/_clients_folder\/maisonjohanesboubee\/_3245415350075_haut_10l_bib_igp_pays_d_oc_cinsault_grenache_rse_hdc_nm_46690_jpg_24304_mini.jpg"
}
]
},
"fields":{
"specificationspro":[
{
"label":"Ionisation",
"value":"",
"slug":"undefined"
},
{
"label":"Sucre r\u00e9siduel",
"value":"",
"slug":"specifications-residual-sugar",
"unit":"g\/l"
},
{
"label":"Acidit\u00e9 tartrique",
"value":"",
"slug":"specifications-tartaric-acidity",
"unit":"g\/l"
},
{
"label":"pH",
"value":"",
"slug":"specifications-ph"
},
{
"label":"Age moyen des vignes",
"value":"",
"slug":"specifications-vines-age",
"unit":"ans"
},
{
"label":"Acidit\u00e9 volatile",
"value":"",
"slug":"specifications-volatile-acidity",
"unit":"g\/l"
},
{
"label":"Acidit\u00e9 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"
}
],
"logistique":[
{
"label":"Type de bouteille",
"value":"",
"slug":"logistic-bottle-type"
},
{
"label":"Code article",
"value":"46690",
"slug":"logistic-product-sku"
},
{
"label":"UPC bouteille",
"value":"3245415350075",
"slug":"logistic-bottle-upc"
},
{
"label":"UPC Carton",
"value":"",
"slug":"logistic-case-upc"
},
{
"label":"Contenance",
"value":"",
"slug":"logistic-bottle-capacity",
"unit":"ml"
},
{
"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 (kg)",
"value":"",
"slug":"logistic-unit-weight",
"unit":"kg"
},
{
"label":"Poids carton (kg)",
"value":"",
"slug":"logistic-case-weight",
"unit":"kg"
},
{
"label":"Poids palette (kg)",
"value":"",
"slug":"logistic-pallet-weight",
"unit":"kg"
},
{
"label":"Hauteur btlle",
"value":"",
"slug":"logistic-bottle-height",
"unit":"cm"
},
{
"label":"Diam\u00e8tre btlle (cm)",
"value":"",
"slug":"logistic-bottle-diameter",
"unit":"cm"
},
{
"label":"Dimensions cartons (HxLxP cm)",
"value":"",
"slug":"logistic-case-dimensions",
"unit":"H*L*P cm"
},
{
"label":"Dimensions palette (HxLxP cm)",
"value":"",
"slug":"logistic-pallet-dimensions",
"unit":"H*L*P cm"
}
],
"advice":[
{
"label":"Service",
"value":"Servir entre 8\u00b0 et 10\u00b0C.",
"slug":"advice-service"
},
{
"label":"Potentiel de garde",
"value":"A boire dans l'ann\u00e9e.",
"slug":"undefined"
},
{
"label":"D\u00e9gustation",
"value":"Une robe rose pale.
\nUn nez de fruits rouges frais.
\nLa bouche est ronde, onctueuse et tr\u00e8s fruit\u00e9e.",
"slug":"advice-tasting"
},
{
"label":"Vid\u00e9o de d\u00e9gustation",
"value":"",
"slug":"video-tasting"
},
{
"label":"Aspect visuel",
"value":"",
"slug":"undefined"
},
{
"label":"Au nez",
"value":"",
"slug":"undefined"
},
{
"label":"En bouche",
"value":"",
"slug":"undefined"
},
{
"label":"Accords Mets-Vins",
"value":"Excellent \u00e0 l'ap\u00e9ritif, il s'accorde parfaitement sur les grillades. il est le compagnon id\u00e9al d'un barbecue entre amis.",
"slug":"advice-pairing"
}
],
"presentation":[
{
"label":"Le vin",
"value":"L'H\u00e9ritage de Carillan est un vin de terroir travaill\u00e9 avec soin, dans le respect de la tradition. Aromatique, fruit\u00e9e et gourmande, cette gamme de vins 'plaisir' est \u00e0 partager et \u00e0 d\u00e9couvrir d\u00e8s l'ap\u00e9ritif et tout au long du repas.",
"slug":"presentation-the-wine"
},
{
"label":"Vid\u00e9o de Pr\u00e9sentation",
"value":"",
"slug":"video-presentation"
},
{
"label":"Le mill\u00e9sime",
"value":"",
"slug":"presentation-vintage-year"
},
{
"label":"Situation",
"value":"",
"slug":"presentation-situation"
},
{
"label":"Terroir",
"value":"",
"slug":"presentation-terroir"
},
{
"label":"A la vigne",
"value":"",
"slug":"presentation-vineyard"
},
{
"label":"Vendanges",
"value":"",
"slug":"presentation-harvest-starts" },
{
"label":"Vinification",
"value":"",
"slug":"presentation-vinification"
},
{
"label":"Elevage",
"value":"",
"slug":"presentation-maturation"
}
],
"specifications":[
{
"label":"Teneur en alcool",
"value":"12,5",
"slug":"specifications-tav",
"unit":"% vol."
},
{
"label":"Allerg\u00e8nes (sulfite)",
"value":"",
"slug":"specifications-allergens-sulphites"
},
{
"label":"Allerg\u00e8nes (oeuf)",
"value":"",
"slug":"specifications-allergens-milk"
},
{
"label":"OGM",
"value":"",
"slug":"specifications-ogm"
},
{
"label":"Certification",
"value":"",
"slug":"undefined"
},
{
"label":"Labels agricoles",
"value":"",
"slug":"specifications-certifications"
}
]
},
"skus":{
"sku":[
{
"name":"L'H\u00e9ritage de Carillan, Cinsault et Grenache, IGP Pays d'Oc, Ros\u00e9, BIB 10L",
"conditioning":"",
"capacity":"10000",
"itemcode":"46690",
"barcode":"3245415350075",
"barcodetype":"ean13"
}
]
}
}
]
}
}
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","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\u00e9al \u00e0 l'ap\u00e9ritif 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":"","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","nutritions":{"nutrition":[{"nutrition_id":"63356db01f2a3","label":"D\u00e9claration nutritionnelle Europe","url":"https:\/\/m.familleperrin.com\/21B9EF\/n\/63356db01f2a3","batch_number":"","tav":"12.50","conditioning_label":"Bouteille (75 cl)","conditioning_capacity":"750","serving_label":"Dose de 12,5 cl","serving_capacity":"125","ingredients":"Raisin, conservateurs (sulfites)","nutrition_values":{"nutrition_value":[{"label":"Energie - Calories","value":"70","slug":"energy-kcal","unit":"kcal\/100ml"},{"label":"Energie - Joules","value":"293","slug":"energy-kj","unit":"kJ\/100ml"},{"label":"Lipides","value":"0.00","slug":"fat","unit":"g\/100ml"},{"label":" dont acides gras satur\u00e9s","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\u00e9ines","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.