Carrefour Suggest
Carrefour Suggest via API.
Credit cost: 2 credits per call
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
query*string
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.piloterr.com/v2/carrefour/suggest?query=string"[
{
"name": "Example",
"value": {
"results": [
{
"id": "product-5000112611861",
"meta": {
"cta": "buy",
"features": {
"swap": false,
"feedback": false,
"deletable": false,
"freshness": false
},
"recommendation": null
},
"type": "product",
"links": {
"self": "/p/soda-au-cola-gout-original-coca-cola-5000112611861",
"reviews": "/product/5000112611861/reviews"
},
"attributes": {
"ean": "5000112611861",
"uri": "boissons/colas-thes-glaces-et-soft-drinks/colas",
"slug": "soda-au-cola-gout-original-coca-cola",
"brand": "COCA-COLA",
"clubs": [],
"flags": [],
"title": "Soda au Cola Goût Original COCA-COLA",
"cdbase": "6545729",
"format": "1,75L",
"images": {
"paths": [
"https://media.carrefour.fr/medias/ae537bba4fd64333b73d2226158bb23c/p_FORMAT/05000112611861_H1N1_s01.png"
],
"formats": {
"common": [
"43x43",
"200x200",
"540x540",
"1500x1500"
],
"largest": "540x540"
}
},
"offers": {
"5000112611861": {
"0261_150_6": {
"id": "0261-150-6",
"meta": {
"cta": "buy"
},
"type": "offer",
"links": {
"self": ""
},
"subtype": "carrefour",
"attributes": {
"ean": "5000112611861",
"isnew": false,
"price": {
"price": 2.39,
"perunit": 1.37,
"taxmessage": "",
"perunitlabel": "1.37 € / L",
"unitofmeasure": "L"
},
"bundle": {
"label": null
},
"isclcv": false,
"isziqy": false,
"ordering": {
"max": 50,
"min": 1,
"step": 1
},
"preorder": null,
"freshness": null,
"ishealthy": false,
"promotion": null,
"guarantees": [],
"promotions": [],
"description": null,
"iswholesale": false,
"marketplace": null,
"availability": {
"stopped": false,
"suspended": false,
"purchasable": true,
"indispensable": false,
"haslowquantity": false,
"suspensionreason": null
},
"isinnovation": false,
"isdigitalcard": false,
"isrecoverable": false,
"isrexeligible": false,
"highlightlabel": null,
"offerserviceid": "0261-150-6",
"variableweight": false,
"consumercontact": null,
"operatorcontact": null,
"shopreturnpolicy": null,
"isexpressdelivery": false,
"isnonfooddelivery": false,
"isphysicalstoreoffer": false,
"isrelaypointeligible": false,
"expresswithdrawaleligibility": {
"global": false,
"incurrentstore": false
}
}
}
}
},
"origin": "",
"variants": [],
"packaging": "la bouteille d'1,75L",
"categories": [
{
"id": "27070",
"uri": "boissons",
"code": "R00F00SF00",
"slug": "boissons",
"type": "RAYON",
"label": "Boissons",
"level": 1,
"sellerid": null
},
{
"id": "27073",
"uri": "boissons/colas-thes-glaces-et-soft-drinks",
"code": "R00F00SF00",
"slug": "colas-thes-glaces-et-soft-drinks",
"type": "RAYON",
"label": "Colas, Thés glacés, Sirops et Sodas",
"level": 2,
"sellerid": null
},
{
"id": "27098",
"uri": "boissons/colas-thes-glaces-et-soft-drinks/colas",
"code": "R00F00SF00",
"slug": "colas",
"type": "RAYON",
"label": "Colas",
"level": 3,
"sellerid": null
}
],
"isdonation": false,
"moreoffers": {
"count": 0,
"bestofferid": null,
"isrexeligible": false,
"bestofferprice": null,
"hascarrefourplus": false,
"withdrawaldelivery": {
"exists": false,
"expresswithdrawaleligibility": {
"global": false,
"incurrentstore": false
}
},
"hasnonfooddeliveryoffer": false
},
"nutriscore": null,
"shorttitle": "Soda au Cola Goût Original COCA-COLA",
"keyfeatures": [],
"businesstype": "food",
"isbestseller": false,
"traceability": null,
"offerserviceid": "0261-150-6",
"customerreviews": {
"count": 33,
"rates": null,
"average": 4.79
},
"topcategoryname": "Boissons",
"deliverymodalities": [],
"weightsandmeasures": [],
"sustainabilityindex": null,
"guarantee_general_document": "https://static-cms.carrefour.fr/sites/default/files/documents/garanties-carrefour-plus-document-information-cgv.pdf"
},
"relationships": {
"substitution": null
}
},
{
"id": "product-5000112635300",
"meta": {
"cta": "buy",
"features": {
"swap": false,
"feedback": false,
"deletable": false,
"freshness": false
},
"recommendation": null
},
"type": "product",
"links": {
"self": "/p/soda-au-cola-gout-original-coca-cola-5000112635300",
"reviews": "/product/5000112635300/reviews"
},
"attributes": {
"ean": "5000112635300",
"uri": "boissons/colas-thes-glaces-et-soft-drinks/colas",
"slug": "soda-au-cola-gout-original-coca-cola",
"brand": "COCA-COLA",
"clubs": [],
"flags": [],
"title": "Soda au Cola Goût Original COCA-COLA",
"cdbase": "6554774",
"format": "6x1,75L",
"images": {
"paths": [
"https://media.carrefour.fr/medias/cf79697517a24530b37aa92a892e10b5/p_FORMAT/05000112635300_H1L1_s01.png",
"https://media.carrefour.fr/medias/69fdb0cd63184eefb7707a707fe7ffad/p_FORMAT/05000112635300_A9C1_s01.png"
],
"formats": {
"common": [
"43x43",
"200x200",
"540x540",
"1500x1500"
],
"largest": "540x540"
}
},
"offers": {
"5000112635300": {
"0261_150_6": {
"id": "0261-150-6",
"meta": {
"cta": "buy"
},
"type": "offer",
"links": {
"self": ""
},
"subtype": "carrefour",
"attributes": {
"ean": "5000112635300",
"isnew": false,
"price": {
"price": 12.91,
"perunit": 1.23,
"taxmessage": "",
"perunitlabel": "1.23 € / L",
"unitofmeasure": "L"
},
"bundle": {
"label": null
},
"isclcv": false,
"isziqy": false,
"ordering": {
"max": 10,
"min": 1,
"step": 1
},
"preorder": null,
"freshness": null,
"ishealthy": false,
"promotion": {
"type": "ta",
"label": "Vu en catalogue",
"ispromo": false,
"message": "promotion.ta",
"isloyalty": false,
"mandateid": [
"2025000639801"
],
"iscrescendo": false,
"isdisplayed": true,
"isprixbarre": false,
"isprixforce": false,
"messageargs": {
"enddate": "2025-11-10T23:59:00+0100",
"quantity": 1,
"startdate": "2025-10-23T00:00:00+0200",
"initialprice": 12.91,
"discountamount": 0,
"discountedprice": 12.91,
"discountedpriceperunit": null
},
"progression": {
"total": null,
"current": null,
"completed": null
},
"bestquantity": 1,
"isclubactive": false,
"mixablegtins": [],
"promoenddate": "2025-11-10T23:59:00+0100",
"promostartdate": "2025-10-23T00:00:00+0200",
"promotionparts": [],
"isvuencatalogue": true,
"ispricealreadydiscounted": true
},
"guarantees": [],
"promotions": [
{
"type": "ta",
"label": "Vu en catalogue",
"ispromo": false,
"message": "promotion.ta",
"isloyalty": false,
"mandateid": [
"2025000639801"
],
"iscrescendo": false,
"isdisplayed": true,
"isprixbarre": false,
"isprixforce": false,
"messageargs": {
"enddate": "2025-11-10T23:59:00+0100",
"quantity": 1,
"startdate": "2025-10-23T00:00:00+0200",
"initialprice": 12.91,
"discountamount": 0,
"discountedprice": 12.91,
"discountedpriceperunit": null
},
"progression": {
"total": null,
"current": null,
"completed": null
},
"bestquantity": 1,
"isclubactive": false,
"mixablegtins": [],
"promoenddate": "2025-11-10T23:59:00+0100",
"promostartdate": "2025-10-23T00:00:00+0200",
"promotionparts": [],
"isvuencatalogue": true,
"ispricealreadydiscounted": true
}
],
"description": null,
"iswholesale": false,
"marketplace": null,
"availability": {
"stopped": false,
"suspended": false,
"purchasable": true,
"indispensable": false,
"haslowquantity": false,
"suspensionreason": null
},
"isinnovation": false,
"isdigitalcard": false,
"isrecoverable": false,
"isrexeligible": false,
"highlightlabel": {
"type": "promotion",
"value": "Vu en catalogue"
},
"offerserviceid": "0261-150-6",
"variableweight": false,
"consumercontact": null,
"operatorcontact": null,
"shopreturnpolicy": null,
"isexpressdelivery": false,
"isnonfooddelivery": false,
"isphysicalstoreoffer": false,
"isrelaypointeligible": false,
"expresswithdrawaleligibility": {
"global": false,
"incurrentstore": false
}
}
}
}
},
"origin": "",
"variants": [],
"packaging": "le pack de 6 bouteilles de 1,75L",
"categories": [
{
"id": "27070",
"uri": "boissons",
"code": "R00F00SF00",
"slug": "boissons",
"type": "RAYON",
"label": "Boissons",
"level": 1,
"sellerid": null
},
{
"id": "27073",
"uri": "boissons/colas-thes-glaces-et-soft-drinks",
"code": "R00F00SF00",
"slug": "colas-thes-glaces-et-soft-drinks",
"type": "RAYON",
"label": "Colas, Thés glacés, Sirops et Sodas",
"level": 2,
"sellerid": null
},
{
"id": "27098",
"uri": "boissons/colas-thes-glaces-et-soft-drinks/colas",
"code": "R00F00SF00",
"slug": "colas",
"type": "RAYON",
"label": "Colas",
"level": 3,
"sellerid": null
}
],
"isdonation": false,
"moreoffers": {
"count": 0,
"bestofferid": null,
"isrexeligible": false,
"bestofferprice": null,
"hascarrefourplus": false,
"withdrawaldelivery": {
"exists": false,
"expresswithdrawaleligibility": {
"global": false,
"incurrentstore": false
}
},
"hasnonfooddeliveryoffer": false
},
"nutriscore": {
"value": "N",
"source": "",
"licence": "",
"iscalculated": false
},
"shorttitle": "Soda au Cola Goût Original",
"keyfeatures": [],
"businesstype": "food",
"isbestseller": false,
"traceability": null,
"offerserviceid": "0261-150-6",
"customerreviews": {
"count": 4,
"rates": null,
"average": 4.75
},
"topcategoryname": "Boissons",
"deliverymodalities": [],
"weightsandmeasures": [],
"sustainabilityindex": null,
"guarantee_general_document": "https://static-cms.carrefour.fr/sites/default/files/documents/garanties-carrefour-plus-document-information-cgv.pdf"
},
"relationships": {
"substitution": null
}
},
{
"id": "product-5449000165534",
"meta": {
"cta": "buy",
"features": {
"swap": false,
"feedback": false,
"deletable": false,
"freshness": false
},
"recommendation": null
},
"type": "product",
"links": {
"self": "/p/soda-au-cola-gout-original-coca-cola-5449000165534",
"reviews": "/product/5449000165534/reviews"
},
"attributes": {
"ean": "5449000165534",
"uri": "grands-formats",
"slug": "soda-au-cola-gout-original-coca-cola",
"brand": "COCA-COLA",
"clubs": [],
"flags": [],
"title": "Soda au Cola Goût Original COCA-COLA",
"cdbase": "6703427",
"format": "4x1,75L",
"images": {
"paths": [
"https://media.carrefour.fr/medias/69528c8635a54588b6a53c3aa383ce40/p_FORMAT/05449000165534_H1L1_s01.png"
],
"formats": {
"common": [
"43x43",
"200x200",
"540x540",
"1500x1500"
],
"largest": "540x540"
}
},
"offers": {
"5449000165534": {
"0261_150_6": {
"id": "0261-150-6",
"meta": {
"cta": "buy"
},
"type": "offer",
"links": {
"self": ""
},
"subtype": "carrefour",
"attributes": {
"ean": "5449000165534",
"isnew": false,
"price": {
"price": 9.56,
"perunit": 1.37,
"taxmessage": "",
"perunitlabel": "1.37 € / L",
"unitofmeasure": "L"
},
"bundle": {
"label": null
},
"isclcv": false,
"isziqy": false,
"ordering": {
"max": 10,
"min": 1,
"step": 1
},
"preorder": null,
"freshness": null,
"ishealthy": false,
"promotion": null,
"guarantees": [],
"promotions": [],
"description": null,
"iswholesale": false,
"marketplace": null,
"availability": {
"stopped": false,
"suspended": false,
"purchasable": true,
"indispensable": false,
"haslowquantity": false,
"suspensionreason": null
},
"isinnovation": false,
"isdigitalcard": false,
"isrecoverable": false,
"isrexeligible": false,
"highlightlabel": null,
"offerserviceid": "0261-150-6",
"variableweight": false,
"consumercontact": null,
"operatorcontact": null,
"shopreturnpolicy": null,
"isexpressdelivery": false,
"isnonfooddelivery": false,
"isphysicalstoreoffer": false,
"isrelaypointeligible": false,
"expresswithdrawaleligibility": {
"global": false,
"incurrentstore": false
}
}
}
}
},
"origin": "",
"variants": [],
"packaging": "le pack de 4 bouteilles de 1,75L",
"categories": [
{
"id": "27070",
"uri": "boissons",
"code": "R00F00SF00",
"slug": "boissons",
"type": "RAYON",
"label": "Boissons",
"level": 1,
"sellerid": null
},
{
"id": "27073",
"uri": "boissons/colas-thes-glaces-et-soft-drinks",
"code": "R00F00SF00",
"slug": "colas-thes-glaces-et-soft-drinks",
"type": "RAYON",
"label": "Colas, Thés glacés, Sirops et Sodas",
"level": 2,
"sellerid": null
},
{
"id": "27098",
"uri": "boissons/colas-thes-glaces-et-soft-drinks/colas",
"code": "R00F00SF00",
"slug": "colas",
"type": "RAYON",
"label": "Colas",
"level": 3,
"sellerid": null
}
],
"isdonation": false,
"moreoffers": {
"count": 0,
"bestofferid": null,
"isrexeligible": false,
"bestofferprice": null,
"hascarrefourplus": false,
"withdrawaldelivery": {
"exists": false,
"expresswithdrawaleligibility": {
"global": false,
"incurrentstore": false
}
},
"hasnonfooddeliveryoffer": false
},
"nutriscore": {
"value": "N",
"source": "",
"licence": "",
"iscalculated": false
},
"shorttitle": "Soda au Cola Goût Original COCA-COLA",
"keyfeatures": [],
"businesstype": "food",
"isbestseller": false,
"traceability": null,
"offerserviceid": "0261-150-6",
"customerreviews": {
"count": 1,
"rates": null,
"average": 5
},
"topcategoryname": "Boissons",
"deliverymodalities": [],
"weightsandmeasures": [],
"sustainabilityindex": null,
"guarantee_general_document": "https://static-cms.carrefour.fr/sites/default/files/documents/garanties-carrefour-plus-document-information-cgv.pdf"
},
"relationships": {
"substitution": null
}
},
{
"id": "product-5449000267412",
"meta": {
"cta": "buy",
"features": {
"swap": false,
"feedback": false,
"deletable": false,
"freshness": false
},
"recommendation": null
},
"type": "product",
"links": {
"self": "/p/soda-au-cola-gout-original-coca-cola-5449000267412",
"reviews": "/product/5449000267412/reviews"
},
"attributes": {
"ean": "5449000267412",
"uri": "boissons/colas-thes-glaces-et-soft-drinks/colas",
"slug": "soda-au-cola-gout-original-coca-cola",
"brand": "COCA-COLA",
"clubs": [],
"flags": [],
"title": "Soda au Cola Goût Original COCA-COLA",
"cdbase": "6693287",
"format": "1,25L",
"images": {
"paths": [
"https://media.carrefour.fr/medias/385bc17366f3445890d2989b26ff8518/p_FORMAT/05449000267412_H1C1_s04.png",
"https://media.carrefour.fr/medias/5532d18e614047f28dd7700e0a23bf24/p_FORMAT/05449000267412_C7N1_s03.png"
],
"formats": {
"common": [
"43x43",
"200x200",
"540x540",
"1500x1500"
],
"largest": "540x540"
}
},
"offers": {
"5449000267412": {
"0261_150_6": {
"id": "0261-150-6",
"meta": {
"cta": "buy"
},
"type": "offer",
"links": {
"self": ""
},
"subtype": "carrefour",
"attributes": {
"ean": "5449000267412",
"isnew": false,
"price": {
"price": 1.89,
"perunit": 1.51,
"taxmessage": "",
"perunitlabel": "1.51 € / L",
"unitofmeasure": "L"
},
"bundle": {
"label": null
},
"isclcv": false,
"isziqy": false,
"ordering": {
"max": 50,
"min": 1,
"step": 1
},
"preorder": null,
"freshness": null,
"ishealthy": false,
"promotion": null,
"guarantees": [],
"promotions": [],
"description": null,
"iswholesale": false,
"marketplace": null,
"availability": {
"stopped": false,
"suspended": false,
"purchasable": true,
"indispensable": false,
"haslowquantity": false,
"suspensionreason": null
},
"isinnovation": false,
"isdigitalcard": false,
"isrecoverable": false,
"isrexeligible": false,
"highlightlabel": null,
"offerserviceid": "0261-150-6",
"variableweight": false,
"consumercontact": null,
"operatorcontact": null,
"shopreturnpolicy": null,
"isexpressdelivery": false,
"isnonfooddelivery": false,
"isphysicalstoreoffer": false,
"isrelaypointeligible": false,
"expresswithdrawaleligibility": {
"global": false,
"incurrentstore": false
}
}
}
}
},
"origin": "",
"variants": [],
"packaging": "la bouteille d'1,25L",
"categories": [
{
"id": "27070",
"uri": "boissons",
"code": "R00F00SF00",
"slug": "boissons",
"type": "RAYON",
"label": "Boissons",
"level": 1,
"sellerid": null
},
{
"id": "27073",
"uri": "boissons/colas-thes-glaces-et-soft-drinks",
"code": "R00F00SF00",
"slug": "colas-thes-glaces-et-soft-drinks",
"type": "RAYON",
"label": "Colas, Thés glacés, Sirops et Sodas",
"level": 2,
"sellerid": null
},
{
"id": "27098",
"uri": "boissons/colas-thes-glaces-et-soft-drinks/colas",
"code": "R00F00SF00",
"slug": "colas",
"type": "RAYON",
"label": "Colas",
"level": 3,
"sellerid": null
}
],
"isdonation": false,
"moreoffers": {
"count": 0,
"bestofferid": null,
"isrexeligible": false,
"bestofferprice": null,
"hascarrefourplus": false,
"withdrawaldelivery": {
"exists": false,
"expresswithdrawaleligibility": {
"global": false,
"incurrentstore": false
}
},
"hasnonfooddeliveryoffer": false
},
"nutriscore": {
"value": "E",
"source": "",
"licence": "",
"iscalculated": false
},
"shorttitle": "Soda au Cola Goût Original COCA-COLA",
"keyfeatures": [],
"businesstype": "food",
"isbestseller": false,
"traceability": null,
"offerserviceid": "0261-150-6",
"customerreviews": {
"count": 19,
"rates": null,
"average": 4.58
},
"topcategoryname": "Boissons",
"deliverymodalities": [],
"weightsandmeasures": [],
"sustainabilityindex": null,
"guarantee_general_document": "https://static-cms.carrefour.fr/sites/default/files/documents/garanties-carrefour-plus-document-information-cgv.pdf"
},
"relationships": {
"substitution": null
}
}
]
}
}
]{
"error": "Bad Request"
}{
"error": "Invalid API Key"
}{
"error": "Payment required"
}{
"error": "Rate limit exceeded for the API key: quota monthly"
}{
"error": "Internal Error"
}