Get all the wines information by a search term.
To be used when you want informations about a wine calling if by keywords in the name of 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
Parameters
Format : json or xml
Target : wine
Method : GetWinesBySearch
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)
KEYWORD : search term. Has to be in the name of the wine. Spaces in the keyword must be replaced by 20% and cabalistic signs are forbidden.
OWNERVINCOD : Vincod of the owner in whose Catalogue you want to search
WINERYVINCOD : Vincod of the winery in which you want to search. You need to provide at least an owner or a winery. If you provide both, the search will focus on the winery
FILTERS : GrapesVarieties, Fields, Recipes, Shops, Reviews, Products, Skus, Medias < set to 0 or 1 to exclude or include < by default all included
Sample
Success
{
"wines": {
"wine": [
{
"vincod": "KUMPZF",
"name": "Crémant de Loire Brut Blanc \"La Petite Marquise\"",
"name_standard": "Plaisir Epicurien, Crémant de Loire Brut Blanc \"La Petite Marquise\", AOP Crémant de Loire, Effervescent Brut, 0",
"ownername": "ALLIANCE LOIRE",
"familyname": "Marché Grande Distribution",
"wineryname": "Plaisir Epicurien",
"rangename": "",
"more": "Crémant de Loire Brut Blanc \"La Petite Marquise\"",
"appellation": "AOP Crémant de Loire",
"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": "Effervescent",
"winetype": "Effervescent Brut",
"winetypecolor": "Blanc",
"vintageyear": "",
"abstract": "Cette cuvée est emblématique de notre savoir-faire dans l'élaboration de vins effervescents de Loire, selon la Méthode Traditionnelle, développée depuis 1953.",
"picture": "https://cdn.vin.co/_clients_folder/allianceloire/Cremant_de_Loire_brut_La_Petite_Marquise_verte_1595863034_retina.jpg",
"tag": "https://cdn.vin.co/_clients_folder/allianceloire/_cremant_de_loire_brut_blanc_la_petite_marquise_jpg_20776_retina.jpg",
"backlabel": "",
"cover": "",
"banner": "",
"dateupdate": "1616155259",
"vincodperso": "",
"language_abrv": "fr",
"wineid": "24555",
"wineryid": "5374",
"parentid": "5374D45AN9",
"familyvincod": "137F3T3TWM",
"wineryvincod": "5374D45AN9",
"rangevincod": "",
"idfiche": "71587",
"id": "46102"
},
{
"vincod": "MMZCEF",
"name": "Cabernet d'Anjou - Pierre Premier",
"name_standard": "Plaisir Epicurien, Cabernet d'Anjou - Pierre Premier, AOP Cabernet d'Anjou, Rosé, 0",
"ownername": "ALLIANCE LOIRE",
"familyname": "Marché Grande Distribution",
"wineryname": "Plaisir Epicurien",
"rangename": "",
"more": "Cabernet d'Anjou - Pierre Premier",
"appellation": "AOP Cabernet d'Anjou",
"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": "Rosé",
"winetypecolor": "Rosé",
"vintageyear": "",
"abstract": "Ce Cabernet d'Anjou est un rosé doux, légèrement sucré, facile à boire.",
"picture": "https://cdn.vin.co/_clients_folder/allianceloire/cabernet_anjou_pierre_premier_1616400438_retina.jpg",
"tag": "",
"backlabel": "",
"cover": "",
"banner": "",
"dateupdate": "1623228851",
"vincodperso": "",
"language_abrv": "fr",
"wineid": "24594",
"wineryid": "5374",
"parentid": "5374D45AN9",
"familyvincod": "137F3T3TWM",
"wineryvincod": "5374D45AN9",
"rangevincod": "",
"idfiche": "71679",
"id": "46174"
},
{
"vincod": "R2EZJF",
"name": "Saumur Champigny - La Mouche du Coche",
"name_standard": "Plaisir Epicurien, Saumur Champigny - La Mouche du Coche, AOP Saumur-Champigny, Rouge, 2019",
"ownername": "ALLIANCE LOIRE",
"familyname": "Marché Grande Distribution",
"wineryname": "Plaisir Epicurien",
"rangename": "",
"more": "Saumur Champigny - La Mouche du Coche",
"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": "2019",
"abstract": "",
"picture": "https://cdn.vin.co/_clients_folder/allianceloire/BLLE_AXE_05B_DNE_LA_MOUCHE_DU_COCHE_1616505508_retina.jpg",
"tag": "https://cdn.vin.co/_clients_folder/allianceloire/La_mouche_du_coche_JPG_1616505412_retina.jpg",
"backlabel": "",
"cover": "",
"banner": "",
"dateupdate": "1616505354",
"vincodperso": "",
"language_abrv": "fr",
"wineid": "24694",
"wineryid": "5374",
"parentid": "5374D45AN9",
"familyvincod": "137F3T3TWM",
"wineryvincod": "5374D45AN9",
"rangevincod": "",
"idfiche": "71900",
"id": "46351"
},
{
"vincod": "J0FP7F",
"name": "Saint Nicolas de Bourgueil Rouge \"Saint Martin\"",
"name_standard": "Plaisir Epicurien, AOP Saint-Nicolas-de-Bourgueil, Rouge, 0",
"ownername": "ALLIANCE LOIRE",
"familyname": "Marché Grande Distribution",
"wineryname": "Plaisir Epicurien",
"rangename": "",
"more": "",
"appellation": "AOP Saint-Nicolas-de-Bourgueil",
"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": "",
"abstract": "",
"picture": "https://cdn.vin.co/_clients_folder/allianceloire/_saint_nicolas_de_bourgueil_saint_martin_png_20419_retina.png",
"tag": "https://cdn.vin.co/_clients_folder/allianceloire/_saint_nicolas_de_bourgueil_saint_martin_jpg_20731_retina.jpg",
"backlabel": "",
"cover": "",
"banner": "",
"dateupdate": "1521646333",
"vincodperso": "",
"language_abrv": "fr",
"wineid": "11474",
"wineryid": "5374",
"parentid": "5374D45AN9",
"familyvincod": "137F3T3TWM",
"wineryvincod": "5374D45AN9",
"rangevincod": "",
"idfiche": "34019",
"id": "19447"
}
]
}
}Error
{
"wines": {
"error": "No wine founds"
}
}