Get wines’ informations of all wines of a winery’s range by its Id.
To be used when you have a winery’s range id (VINCOD) and you want to get wines’ informations of all of its wines in the LANGUAGE of your choice.
By default it will return all informations.
You can add FILTERS to exclude some informations and save time in the request.
Request
http://api.vincod.com/3/json/wine/GetWinesByRangeId/<language>/<VINCOD>?<FILTERS>&apiKey=YOURAPIKEY
Parameters
Format : json or xml
Target : wine
Method : GetWinesByRangeId
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 winery’s range
FILTERS : GrapesVarieties, Fields, Recipes, Shops, Reviews, Products, Skus < set to 0 or 1 to exclude or include < by default all included
Sample default request
http://api.vincod.com/3/json/wine/GetWinesByRangeId/fr/1045GT1RR6?apiKey=#
{ "wines":{ "wine":[ { "vincod":"URSJXF", "name":"Terres de Saint Louis, ros\u00e9, 150cl", "name_standard":"Estandon Signature, Terres de Saint Louis, AOP Coteaux varois en Provence, Ros\u00e9, 2018", "ownername":"ESTANDON", "wineryname":"Estandon Signature", "rangename":"Terres de Saint Louis", "more":"", "appellation":"AOP Coteaux varois en Provence", "region":"Provence", "subregion":"", "country":"France", "winecategory":"Vin Tranquille", "winetype":"Ros\u00e9", "winetypecolor":"Ros\u00e9", "vintageyear":"2018", "abstract":"Le Coteaux Varois en Provence, par excellence, avec sa bouteille originale et exclusive.", "picture":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_640.png", "tag":"", "backlabel":"", "cover":"", "dateupdate":"1546530686", "climat_revendique":"", "climat_revendique_signification":"", "chablis_premier_cru_climat_origine":"", "vincodperso":"", "wineid":"15036", "wineryid":"1045", "parentid":"1045GT1RR6", "wineryvincod":"899DOZN3RT", "rangevincod":"1045GT1RR6", "idfiche":"42379", "id":"25662", "grapesvarieties":{ "variety":[ { "name":"Cinsault", "amount":"" }, { "name":"Grenache", "amount":"" }, { "name":"Syrah", "amount":"" } ] }, "recipes":"", "shops":"", "reviews":"", "products":"", "medias":{ "media":[ { "name":"Terres de Saint Louis ros\u00e9 2018 150cl", "type":"png", "zone":"", "ordre":"1", "url":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902.png", "url_mini":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_mini.png", "url_320":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_320.png", "url_640":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_640.png", "url_1024":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_1024.png", "url_retina":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_retina.png", "preview":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_mini.png" } ] }, "fields":{ "logistique":[ { "label":"Type de bouteille", "value":"Saint Louis Evolution", "slug":"logistic-bottle-type" }, { "label":"Code article", "value":"12677", "slug":"logistic-product-sku" }, { "label":"UPC bouteille", "value":"3269210255205", "slug":"logistic-bottle-upc" }, { "label":"UPC Carton", "value":"3269210105487", "slug":"logistic-case-upc" }, { "label":"Contenance (ml)", "value":"1500", "slug":"logistic-bottle-capacity", "unit":"ml" }, { "label":"Cols par carton", "value":"4", "slug":"logistic-unit-per-case" }, { "label":"Cols par palette", "value":"216", "slug":"logistic-unit-pallet" }, { "label":"Rangs par palette", "value":"6", "slug":"logistic-layers-per-pallet" }, { "label":"Cartons par rang", "value":"9", "slug":"logistic-cases-per-layer" }, { "label":"Poids btlle (kg)", "value":"2.50", "slug":"logistic-unit-weight", "unit":"kg" }, { "label":"Poids carton (kg)", "value":"10.26", "slug":"logistic-case-weight", "unit":"kg" }, { "label":"Poids palette (kg)", "value":"579", "slug":"logistic-pallet-weight", "unit":"kg" }, { "label":"Hauteur btlle (cm)", "value":"40", "slug":"logistic-bottle-height", "unit":"cm" }, { "label":"Diam\u00e8tre btlle (cm)", "value":"10.27", "slug":"logistic-bottle-diameter", "unit":"cm" }, { "label":"Dimensions cartons (HxLxP cm)", "value":"21.4x21.4x40.6", "slug":"logistic-case-dimensions", "unit":"H*L*P cm" }, { "label":"Dimensions palette (HxLxP cm)", "value":"120x80x149", "slug":"logistic-pallet-dimensions", "unit":"H*L*P cm" } ], "advice":[ { "label":"D\u00e9gustation", "value":"Une robe rose p\u00e2le aux nuances violine, un nez tr\u00e8s expressif, exub\u00e9rant, une bouche gourmande, acidul\u00e9e ponctu\u00e9e de fruits frais et de zestes d\u2019agrumes et qui s\u2019ach\u00e8ve sur une finale tr\u00e8s \u00e9l\u00e9gante.", "slug":"advice-tasting" }, { "label":"Service", "value":"A d\u00e9guster entre 6 et 8\u00b0.", "slug":"advice-service" }, { "label":"Accords Mets-Vins", "value":"Il sera aussi bien appr\u00e9ci\u00e9 \u00e0 l\u2019ap\u00e9ritif qu\u2019en accompagnant les saveurs d\u2019un plat m\u00e9diterran\u00e9en.", "slug":"advice-pairing" }, { "label":"Vid\u00e9o de d\u00e9gustation", "value":"", "slug":"video-tasting" } ], "presentation":[ { "label":"Le mill\u00e9sime", "value":"", "slug":"presentation-vintage-year" }, { "label":"Le vin", "value":"Un vin ros\u00e9, ambassadeur des Coteaux varois en Provence, expressif et harmonieux", "slug":"presentation-the-wine" }, { "label":"Terroir", "value":"Encercl\u00e9e par les C\u00f4tes de Provence, l\u2019appellation des Coteaux Varois en Provence, dix fois plus petite que sa grande soeur, poss\u00e8de une typicit\u00e9 bien particuli\u00e8re gr\u00e2ce \u00e0 son terroir et son climat si sp\u00e9cifique....
\nElle est perch\u00e9e en altitude (entre 200 et 500 m\u00e8tres), o\u00f9 les hivers sont rudes et les \u00e9t\u00e9s caniculaires, avec des nuits plus fra\u00eeches.
\nCette alternance de temp\u00e9rature permet une maturit\u00e9 des raisins qui s\u2019op\u00e8re alors en douceur, lentement, permettant de conserver au mieux leurs ar\u00f4mes. Le travail des vignes est certifi\u00e9 AgriConfiance depuis 2007.", "slug":"presentation-terroir" }, { "label":"Vinification", "value":"Les raisins sont essentiellement vendang\u00e9s m\u00e9caniquement, tr\u00e8s t\u00f4t dans la nuit afin d\u2019obtenir cette robe si p\u00e2le.
\nUne courte mac\u00e9ration pelliculaire est op\u00e9r\u00e9e avant le pressurage. Les jus sont d\u00e9bourb\u00e9s \u00e0 basse temp\u00e9rature. La fermentation alcoolique est thermo-r\u00e9gul\u00e9e et la fermentation malolactique, bloqu\u00e9e.
\nLa vinification est effectu\u00e9e de mani\u00e8re traditionnelle en cuve, sous contr\u00f4les de temp\u00e9ratures.", "slug":"presentation-vinification" }, { "label":"Certifications", "value":"Agriconfiance", "slug":"undefined" }, { "label":"Responsable Technique du Vignoble", "value":"Stephan Reinig", "slug":"undefined" }, { "label":"Maitre de Chai", "value":"Catherine Huguenin", "slug":"undefined" }, { "label":"Vid\u00e9o de Pr\u00e9sentation", "value":"", "slug":"video-presentation" } ] }, "skus":"" },{ "vincod":"4NMV5F", "name":"Terres de Saint Louis Rouge 2013", "name_standard":"Estandon Signature, Terres de Saint Louis, AOC Coteaux varois en Provence, Rouge, 2013", "ownername":"ESTANDON", "wineryname":"Estandon Signature", "rangename":"Terres de Saint Louis", "more":"", "appellation":"AOC Coteaux varois en Provence", "region":"Provence", "subregion":"", "country":"France", "winecategory":"Vin Tranquille", "winetype":"Rouge", "winetypecolor":"Rouge", "vintageyear":"2013", "abstract":"L'Incontournable Coteaux Varois en Provence dans sa bouteille \u00e0 la forme unique...", "picture":"", "tag":"", "backlabel":"", "cover":"", "dateupdate":"1437396809", "climat_revendique":"", "climat_revendique_signification":"", "chablis_premier_cru_climat_origine":"", "vincodperso":"", "wineid":"2819", "wineryid":"1045", "parentid":"1045GT1RR6", "wineryvincod":"899DOZN3RT", "rangevincod":"1045GT1RR6", "idfiche":"13184", "id":"7276", "grapesvarieties":{ "variety":[ { "name":"Grenache", "amount":"" }, { "name":"Mourv\u00e8dre", "amount":"" }, { "name":"Syrah", "amount":"" } ] }, "recipes":"", "shops":"", "reviews":"", "products":"", "medias":"", "fields":{ "specificationspro":[ { "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":"Age moyen des vignes", "value":"", "slug":"specifications-vines-age", "unit":"ans" }, { "label":"pH", "value":"", "slug":"specifications-ph" }, { "label":"Rendement", "value":"", "slug":"specifications-vines-yields", "unit":"hL\/ha" }, { "label":"Volume de production", "value":"", "slug":"specifications-production-volume" } ], "logistique":[ { "label":"Type de bouteille", "value":"Saint Louis Evolution", "slug":"logistic-bottle-type" }, { "label":"Code article", "value":"52554", "slug":"logistic-product-sku" }, { "label":"UPC bouteille", "value":"3269210252952", "slug":"logistic-bottle-upc" }, { "label":"UPC Carton", "value":"3269210102752", "slug":"logistic-case-upc" }, { "label":"Contenance (ml)", "value":"75cl", "slug":"logistic-bottle-capacity", "unit":"ml" }, { "label":"Cols par carton", "value":"6", "slug":"logistic-unit-per-case" }, { "label":"Cols par palette", "value":"630", "slug":"logistic-unit-pallet" }, { "label":"Rangs par palette", "value":"5", "slug":"logistic-layers-per-pallet" }, { "label":"Cartons par rang", "value":"21", "slug":"logistic-cases-per-layer" }, { "label":"Poids btlle (kg)", "value":"1.33", "slug":"logistic-unit-weight", "unit":"kg" }, { "label":"Poids carton (kg)", "value":"8.16", "slug":"logistic-case-weight", "unit":"kg" }, { "label":"Poids palette (kg)", "value":"882", "slug":"logistic-pallet-weight", "unit":"kg" }, { "label":"Hauteur btlle (cm)", "value":"32.9", "slug":"logistic-bottle-height", "unit":"cm" }, { "label":"Diam\u00e8tre btlle (cm)", "value":"8.15", "slug":"logistic-bottle-diameter", "unit":"cm" }, { "label":"Dimensions cartons (HxLxP cm)", "value":"26x18x34", "slug":"logistic-case-dimensions", "unit":"H*L*P cm" }, { "label":"Dimensions palette (HxLxP cm)", "value":"120x80x180", "slug":"logistic-pallet-dimensions", "unit":"H*L*P cm" } ], "advice":[ { "label":"D\u00e9gustation", "value":"Le vin rouge Terres de Saint Louis pr\u00e9sente une robe rubis et un nez puissant et fruit\u00e9.
\nEtoff\u00e9e, la bouche r\u00e9v\u00e8le des qualit\u00e9s de fondu et de souplesse.", "slug":"advice-tasting" }, { "label":"Service", "value":"A d\u00e9guster entre 16\u00b0 et 18\u00b0C
", "slug":"advice-service" }, { "label":"Accords Mets-Vins", "value":"Il sera parfait pour accompagner une daube \u00e0 la proven\u00e7ale, ou un coquelet au vin.", "slug":"advice-pairing" }, { "label":"Vid\u00e9o de d\u00e9gustation", "value":"", "slug":"video-tasting" } ], "presentation":[ { "label":"Le mill\u00e9sime", "value":"", "slug":"presentation-vintage-year" }, { "label":"Le vin", "value":"Le terroir de l\u2019AOC Coteaux Varois en Provence se caract\u00e9rise par des reliefs marqu\u00e9s o\u00f9 les parcelles de vignes se situent entre 200 et 500 m\u00e8tres d\u2019altitude.
\nGr\u00e2ce \u00e0 l\u2019alternance de fortes chaleur et de nuits fra\u00eeches, la maturit\u00e9 des raisins est plus longue, plus s\u00fbre et leurs ar\u00f4mes mieux pr\u00e9serv\u00e9s.", "slug":"presentation-the-wine" }, { "label":"Terroir", "value":"", "slug":"presentation-terroir" }, { "label":"Vinification", "value":"Mac\u00e9ration pelliculaire sup\u00e9rieure \u00e0 10 jours en cuve inox.", "slug":"presentation-vinification" }, { "label":"Vid\u00e9o de Pr\u00e9sentation", "value":"", "slug":"video-presentation" } ], "specifications":[ { "label":"Teneur en alcool", "value":"", "slug":"specifications-tav", "unit":"% vol." } ] }, "skus":{ "sku":[ { "name":"Terres de Saint Louis Rouge 2013 75cl", "conditioning":"", "capacity":"", "itemcode":"", "barcode":"3269210252952", "barcodetype":"ean13" } ] } } ] } }
Sample filtered request
http://api.vincod.com/3/json/wine/GetWinesByRangeId/fr/1045GT1RR6?GrapesVarieties=0&Fields=0&Skus=0&Recipes=0&Shops=0&Reviews=0&Products=0&apiKey=#
{ "wines":{ "wine":[ { "vincod":"URSJXF", "name":"Terres de Saint Louis, ros\u00e9, 150cl", "name_standard":"Estandon Signature, Terres de Saint Louis, AOP Coteaux varois en Provence, Ros\u00e9, 2018", "ownername":"ESTANDON", "wineryname":"Estandon Signature", "rangename":"Terres de Saint Louis", "more":"", "appellation":"AOP Coteaux varois en Provence", "region":"Provence", "subregion":"", "country":"France", "winecategory":"Vin Tranquille", "winetype":"Ros\u00e9", "winetypecolor":"Ros\u00e9", "vintageyear":"2018", "abstract":"Le Coteaux Varois en Provence, par excellence, avec sa bouteille originale et exclusive.", "picture":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_640.png", "tag":"", "backlabel":"", "cover":"", "dateupdate":"1546530686", "climat_revendique":"", "climat_revendique_signification":"", "chablis_premier_cru_climat_origine":"", "vincodperso":"", "wineid":"15036", "wineryid":"1045", "parentid":"1045GT1RR6", "wineryvincod":"899DOZN3RT", "rangevincod":"1045GT1RR6", "idfiche":"42379", "id":"25662", "medias":{ "media":[ { "name":"Terres de Saint Louis ros\u00e9 2018 150cl", "type":"png", "zone":"", "ordre":"1", "url":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902.png", "url_mini":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_mini.png", "url_320":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_320.png", "url_640":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_640.png", "url_1024":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_1024.png", "url_retina":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_retina.png", "preview":"http:\/\/test.vincod.vinternet-dev02.reseaux.info\/_clients_folder\/estandon\/_terres_de_saint_louis_ros_2018_150cl_png_25902_mini.png" } ] } },...{ "vincod":"4NMV5F", "name":"Terres de Saint Louis Rouge 2013", "name_standard":"Estandon Signature, Terres de Saint Louis, AOC Coteaux varois en Provence, Rouge, 2013", "ownername":"ESTANDON", "wineryname":"Estandon Signature", "rangename":"Terres de Saint Louis", "more":"", "appellation":"AOC Coteaux varois en Provence", "region":"Provence", "subregion":"", "country":"France", "winecategory":"Vin Tranquille", "winetype":"Rouge", "winetypecolor":"Rouge", "vintageyear":"2013", "abstract":"L'Incontournable Coteaux Varois en Provence dans sa bouteille \u00e0 la forme unique...", "picture":"", "tag":"", "backlabel":"", "cover":"", "dateupdate":"1437396809", "climat_revendique":"", "climat_revendique_signification":"", "chablis_premier_cru_climat_origine":"", "vincodperso":"", "wineid":"2819", "wineryid":"1045", "parentid":"1045GT1RR6", "wineryvincod":"899DOZN3RT", "rangevincod":"1045GT1RR6", "idfiche":"13184", "id":"7276", "medias":"" } ] } }