# Carrefour Morocco Products API

> Carrefour Morocco: 2,100 products with prices and promotions, 158 stores, categories and catalogues

- Vendor: `carrefourmoroccoproductsapi` · version 1.0 · category Food · tags carrefour morocco api, morocco grocery prices api, supermarket products api, carrefour stores api, promotions api, grocery catalogue api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/carrefourmoroccoproductsapi
- This document: https://apiclay.com/docs/carrefourmoroccoproductsapi.md
- OpenAPI 3.1: https://apiclay.com/api/carrefourmoroccoproductsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `carrefourmoroccoproductsapi`
- Updated: 2026-11-18

## About

## Carrefour Morocco Products API

The catalogue behind carrefour.ma, Carrefour's site in Morocco: about 2,100 products with price, crossed-out price, promotion dates, club points, stock status, category and the store banner (Carrefour, Market, Gourmet, Express), searchable and filterable to current promotions; the product categories; 158 stores with address, city, opening hours, services and banner; the current promotional catalogues with PDF links and validity dates; and the four store banners.

Data comes from **carrefour.ma** (https://www.carrefour.ma). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/products?search=lait&amp;page=1&amp;limit=20`, `/products?isPromotion=true` for current deals, `/stores` for the store list, `/catalogues` for this week's leaflets.

### Routes

#### GET `/products` - Products
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| page | query | number | no | Page, from 1. |
| limit | query | number | no | Products per page, e.g. 20. |
| search | query | string | no | Words in the product name, e.g. `lait`. |
| isPromotion | query | string | no | `true` for products on promotion only. |

Returns: `products` array: `name`, `slug`, `mainImageUrl`, `price` and `crossedPrice` (dirhams), `clubPoints`, `status`, `isPromotion`, `promotionStartDate`, `promotionEndDate`, `primaryCategory`, `secondaryCategory`, `internalProductId`, `enseigne` (banner); plus `pagination` (`page`, `limit`, `total`, `totalPages`, `hasNextPage`).

#### GET `/categories` - Categories
No parameters.

Returns: Array of categories: `id`, `name`, `slug`, `description`, `imageUrl`, `order`, `parentId`, and app links per banner.

#### GET `/stores` - Stores
No parameters.

Returns: Array of 158 stores: `name`, `address`, `cityId`, `postalCode`, `openingHours` (JSON text per weekday), `latitude`, `longitude`, `phone`, `hasServiceStation`, `hasParking`, `enseigneId`, `status`.

#### GET `/catalogues` - Catalogues
No parameters.

Returns: Array of current leaflets: `title`, `slug`, `pdfUrl`, `imageUrl`, `startDate`, `endDate`, and the banners they apply to.

#### GET `/banners` - Banners
No parameters.

Returns: Array of the four store banners: `name`, `slug`, `brandColor`, logos and images.

### Caveats

- Prices are in Moroccan dirhams as shown on carrefour.ma and can differ by store. Product names are as the store writes them (often upper case French); catalogue titles can be in Arabic or French. Store coordinates are incomplete for some stores.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by carrefour.ma.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /products — Products
- Gateway: `GET https://api.apiclay.com/v1/api/carrefourmoroccoproductsapi/products`
- Public query params: `page` (number), `limit` (number), `search` (string), `isPromotion` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories
- Gateway: `GET https://api.apiclay.com/v1/api/carrefourmoroccoproductsapi/categories`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /stores — Stores
- Gateway: `GET https://api.apiclay.com/v1/api/carrefourmoroccoproductsapi/stores`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /catalogues — Catalogues
- Gateway: `GET https://api.apiclay.com/v1/api/carrefourmoroccoproductsapi/catalogues`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /banners — Banners
- Gateway: `GET https://api.apiclay.com/v1/api/carrefourmoroccoproductsapi/banners`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/carrefourmoroccoproductsapi/products" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
