Campaign Products

Returns the products inside one home-page section, identified by the campaign_id (UUID or slug) from Home Campaigns . It works for carousels, grids and banners: banner campaigns also return products even though /campaigns reports their items_count as null. The built-in sections have fixed ids, so 00000000-0000-0000-0000-000000000002 always returns the “Bajadas de precio” carousel. Rows don’t include ean, brand, category_path or popularity_score; call Product Details when you need them.

HTTP Request

GET /campaign-products

Parameters

Parameter	Type	Required	Default	Description
`campaign_id`	string	Yes	-	Section id (UUID or slug) from /campaigns . Built-in sections: `00000000-0000-0000-0000-000000000001` (Novedades), `...0002` (Bajadas de precio), `...0003` (Han vuelto)
`warehouse`	string	No	`vlc1`	Hub or 4-digit store code (see Warehouses ). Ignored when `postal_code` is given
`postal_code`	string	No	-	Spanish 5-digit postal code, resolved to the warehouse that serves it. Takes precedence over `warehouse`
`page`	integer	No	`1`	1-indexed page over the section’s items (local pagination)
`per_page`	integer	No	`20`	Items per page, max 20
`fresh`	boolean	No	`false`	Bypass the 10-minute cache
`language`	string	No	`es`	Language for product and category names: `es`, `en` or `ca`

Response

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
{
  "status": true,
  "request_id": "8c6b59cf-b7ba-2328-54ff-44b537b9",
  "cached_at": null,
  "data": {
    "campaign_id": "221d53b1-3372-48a6-bcc9-0fea5cf460af",
    "title": "Nuevo en Perfumería",
    "section_code": "PS",
    "items": [
      {
        "product_id": "18390",
        "name": "Laca de uñas color & queratina Deliplus 159 lavanda",
        "slug": "laca-unas-color-queratina-deliplus-159-lavanda",
        "url": "https://tienda.mercadona.es/product/18390/laca-unas-color-queratina-deliplus-159-lavanda",
        "thumbnail": "https://prod-mercadona.imgix.net/images/6b26f7d5833ced0f1aeb6b802395a556.jpg?fit=crop&h=300&w=300",
        "packaging": null,
        "main_feature": "159 lavanda",
        "is_water": false,
        "requires_age_check": false,
        "category": {
          "category_id": 20,
          "name": "Cuidado facial y corporal"
        },
        "availability": {
          "in_stock": true,
          "status": null,
          "unavailable_from": null,
          "unavailable_weekdays": [],
          "order_limit": 999
        },
        "price": "2.50",
        "price_value": 2.5,
        "previous_price": null,
        "previous_price_value": null,
        "is_price_drop": false,
        "unit_price": "2.500",
        "unit_price_value": 2.5,
        "unit_price_format": "ud",
        "bulk_price_value": 2.5,
        "size_format": "l",
        "unit_size": 0.011,
        "is_pack": false,
        "pack_size": null,
        "total_units": 1,
        "unit_name": "ud.",
        "iva_percent": 21,
        "approx_size": false,
        "drained_weight": null,
        "currency": "EUR",
        "color_variants": null,
        "warehouse": "vlc1"
      },
      {
        "product_id": "18389",
        "name": "Serum uñas & cutículas Double Action Deliplus suaviza e hidrata",
        "slug": "serum-unas-cuticulas-double-action-deliplus-suaviza-hidrata",
        "url": "https://tienda.mercadona.es/product/18389/serum-unas-cuticulas-double-action-deliplus-suaviza-hidrata",
        "thumbnail": "https://prod-mercadona.imgix.net/images/a285f73ad4baa966444799a79bf4ac72.jpg?fit=crop&h=300&w=300",
        "packaging": null,
        "main_feature": "suaviza e hidrata",
        "is_water": false,
        "requires_age_check": false,
        "category": {
          "category_id": 20,
          "name": "Cuidado facial y corporal"
        },
        "availability": {
          "in_stock": true,
          "status": null,
          "unavailable_from": null,
          "unavailable_weekdays": [],
          "order_limit": 999
        },
        "price": "3.50",
        "price_value": 3.5,
        "previous_price": null,
        "previous_price_value": null,
        "is_price_drop": false,
        "unit_price": "3.500",
        "unit_price_value": 3.5,
        "unit_price_format": "ud",
        "bulk_price_value": 3.5,
        "size_format": "l",
        "unit_size": 0.0145,
        "is_pack": false,
        "pack_size": null,
        "total_units": 1,
        "unit_name": "ud.",
        "iva_percent": 21,
        "approx_size": false,
        "drained_weight": null,
        "currency": "EUR",
        "color_variants": null,
        "warehouse": "vlc1"
      }
    ],
    "total": 36,
    "page": 1,
    "per_page": 2,
    "total_pages": 18,
    "has_next_page": true,
    "resolved_filters": {
      "warehouse": {
        "input": null,
        "resolved": "vlc1",
        "source": "default"
      }
    },
    "language": "es"
  },
  "request_params": {
    "campaign_id": "221d53b1-3372-48a6-bcc9-0fea5cf460af",
    "per_page": "2"
  }
}

Response Fields

Field	Type	Description
`status`	boolean	`true` on success
`request_id`	string	Unique request identifier
`cached_at`	string \| null	ISO timestamp when the answer came from cache, `null` when fetched for this request
`data`	object	Response payload
`data.campaign_id`	string	Id of the section
`data.title`	string	Section title
`data.section_code`	string \| null	Mercadona section code, e.g. `PS`
`data.items[]`	array of objects	Products in the section. Rows have no `ean`, `brand`, `category_path` or `popularity_score`
`data.items[].product_id`	string	Mercadona product id. Pass it verbatim: decimal ids like `81241.3` exist
`data.items[].name`	string	Product name, translated with `language`
`data.items[].slug`	string	URL slug of the product
`data.items[].url`	string	Product URL on tienda.mercadona.es
`data.items[].thumbnail`	string	Product image URL (imgix)
`data.items[].packaging`	string \| null	Packaging, e.g. `"Tableta"`, `"Botella"`, `"Pieza"`
`data.items[].main_feature`	string \| null	Highlighted feature shown under the name
`data.items[].is_water`	boolean	Water product flag
`data.items[].requires_age_check`	boolean	Alcohol or other age-restricted product
`data.items[].category`	object	Level-0 category of the product
`data.items[].category.category_id`	integer	Level-0 category id
`data.items[].category.name`	string	Level-0 category name, translated with `language`
`data.items[].availability`	object	Availability at the resolved warehouse
`data.items[].availability.in_stock`	boolean	In stock at the resolved warehouse
`data.items[].availability.status`	string \| null	Restriction status, `null` when there is none
`data.items[].availability.unavailable_from`	string \| null	Date the product stops being available
`data.items[].availability.unavailable_weekdays`	array	Weekdays the product can’t be delivered
`data.items[].availability.order_limit`	integer	Maximum units per order (e.g. `999`)
`data.items[].price`	string	Display price in EUR, e.g. `"1.25"`
`data.items[].price_value`	float	Numeric price in EUR
`data.items[].previous_price`	string \| null	Previous display price, `null` when there is none
`data.items[].previous_price_value`	float \| null	Previous numeric price in EUR
`data.items[].is_price_drop`	boolean	`true` when the current price is below `previous_price`. Computed from the previous price, not Mercadona’s own flag
`data.items[].unit_price`	string	Display unit price, e.g. `"0.800"`
`data.items[].unit_price_value`	float	Numeric unit price
`data.items[].unit_price_format`	string	Unit the unit price refers to, e.g. `"L"`, `"kg"`, `"ud"`
`data.items[].bulk_price_value`	float	Bulk price
`data.items[].size_format`	string	Size unit, e.g. `"l"`, `"kg"`
`data.items[].unit_size`	float	Size in `size_format` units
`data.items[].is_pack`	boolean	Whether the product is a pack
`data.items[].pack_size`	float \| null	Size of each unit in the pack
`data.items[].total_units`	integer \| null	Units in the pack
`data.items[].unit_name`	string \| null	Unit name, e.g. `"ud."`, `"briks"`
`data.items[].iva_percent`	integer	VAT percentage
`data.items[].approx_size`	boolean	Size is approximate (e.g. fruit sold by the piece)
`data.items[].drained_weight`	float \| null	Drained weight
`data.items[].currency`	string	Always `"EUR"`
`data.items[].color_variants`	array \| null	Colour variants
`data.items[].warehouse`	string	Warehouse that answered
`data.total`	integer	Products in the section
`data.page`	integer	Current page (1-indexed)
`data.per_page`	integer	Items per page
`data.total_pages`	integer	Total number of pages
`data.has_next_page`	boolean	Whether another page follows
`data.resolved_filters.warehouse`	object	The warehouse that answered
`data.resolved_filters.warehouse.input`	string \| null	The `postal_code` or `warehouse` you sent, `null` if none
`data.resolved_filters.warehouse.resolved`	string	Warehouse code used, e.g. `mad3`
`data.resolved_filters.warehouse.source`	string	How it was chosen: `postal_code`, `param` or `default`
`data.language`	string	Language used for names: `es`, `en` or `ca`
`request_params`	object	The query parameters you sent, echoed back as strings

Error Responses

An unknown campaign_id returns HTTP 200 with status: false and error.code set to not_found:

1
2
3
4
5
6
{
  "status": false,
  "request_id": "...",
  "error": { "code": "not_found", "message": "..." },
  "data": null
}

Invalid input returns HTTP 400, and error is a plain string:

1
2
3
4
5
6
7
8
{
  "status": false,
  "request_id": "b757e855-4127-3b96-509a-8b573904",
  "error": "Invalid parameter 'warehouse': String should match pattern '^(?:[a-z]{3}[0-9]|[0-9]{4})$'",
  "request_params": {
    "warehouse": "xyz"
  }
}

Status Code	Cause	Description
200	`status: false`, `error.code: not_found`	The `campaign_id` doesn’t match any current section. Get current ids from /campaigns
400	Invalid parameter	Missing `campaign_id`, malformed `warehouse`, or `per_page` above 20

Code Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
import requests

url = "https://mercadona-api.p.rapidapi.com/campaign-products"

params = {
    "campaign_id": "00000000-0000-0000-0000-000000000002"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "mercadona-api.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()["data"]

print(f"{data['title']}: {data['total']} products")
for item in data["items"]:
    print(f"{item['name']}: {item['price_value']} EUR (was {item['previous_price']})")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
const url = "https://mercadona-api.p.rapidapi.com/campaign-products";

const params = new URLSearchParams({
  campaign_id: "00000000-0000-0000-0000-000000000002"
});

const response = await fetch(`${url}?${params}`, {
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "mercadona-api.p.rapidapi.com"
  }
});

const { data } = await response.json();
console.log(`${data.title}: ${data.total} products`);
data.items.forEach(item => {
  console.log(`${item.name}: ${item.price_value} EUR (was ${item.previous_price})`);
});

1
2
3
4
curl -G "https://mercadona-api.p.rapidapi.com/campaign-products" \
  --data-urlencode "campaign_id=00000000-0000-0000-0000-000000000002" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: mercadona-api.p.rapidapi.com"

Home Campaigns : list sections and their campaign_id values
Product Details : add ean, brand and the full product sheet to a row
Price Drops : all products on a price drop, with discount values