# Carrefour Spain Listing Scraper

Extract product information of Carrefour Spain.

- Template page: [https://www.octoparse.com/template/carrefour-listados-scraper](https://www.octoparse.com/template/carrefour-listados-scraper)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from listing pages.

## Output

The current workflow extracts 7 fields, including `ALL`, `Cantidad_Resultado`, `Nombre`, `Precio`, `Promoción`, `URL`, `Unidad`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Keywords and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Keywords

Optional. Enter Keywords Constraints: minItems=1; maxItems=1000; items.minLength=0; items.maxLength=1000.

## How to Use

# Carrefour Spain Listing Scraper

## What It Collects
Product information from [Carrefour](https://www.carrefour.es/) listing pages.

## Pricing
Currently no per-line charge. Octoparse plan or resource limits may apply.

## Output Fields
- `Cantidad_Resultado`
- `Nombre`
- `Precio`
- `Unidad`
- `Promoción`
- `URL`
- `ALL`

## Input
- **Keywords** (optional): Enter one or more values, one per line.

## How to Use
1. Open the template and select **Try it** or **Start**.
2. Complete the input fields listed above.
3. Choose a local or cloud run.
4. Review the output rows and export or process the structured data.

You can schedule recurring runs locally or in the cloud. Scheduling may require a paid Octoparse plan.

## Limitations
- Collects only from listing pages; does not add data that Carrefour does not display.
- Fields such as `Promoción`, `URL`, and `ALL` can be empty when the source does not provide them.

## Tips
- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid Keywords to reduce unrelated or duplicate records.
- Use a stable URL or identifier from `Cantidad_Resultado`, `Nombre`, `Precio`, `Unidad`, `Promoción`, `URL`, and `ALL` as the deduplication key when available.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Booking.com Listing Scraper (for Spain)](https://www.octoparse.com/template/booking-hotel-listados-scraper)
- [Yellow Pages Spain Scraper(Listing)](https://www.octoparse.com/template/paginas-amarillas-listados-scraper)
- [Amazon Product Listing Scraper(for Spain)](https://www.octoparse.com/template/amazon-espana-listados-scraper)
- [eBay Spain Product Listing Scraper (by Keyword)](https://www.octoparse.com/template/ebay-listados-scraper)
- [Carrefour Data Scraper](https://www.octoparse.com/template/carrefour-data-scraper)

## Input Schema

```json
{
  "title": "Carrefour Spain Listing Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "keywords": {
      "title": "Keywords",
      "description": "Enter Keywords",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 1000
      },
      "minItems": 1,
      "maxItems": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": []
}
```

## Input JSON Example

Example 1

```json
{
  "keywords": [
    "chocolate",
    "aceite"
  ]
}
```

Example 2

```json
{
  "keywords": [
    "chocolate",
    "aceite"
  ]
}
```

Example 3

```json
{
  "keywords": [
    "chocolate",
    "aceite"
  ]
}
```

Example 4

```json
{
  "keywords": [
    "chocolate",
    "aceite"
  ]
}
```

Example 5

```json
{
  "keywords": [
    "chocolate",
    "aceite"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "ALL": {
      "type": "string",
      "description": ""
    },
    "Cantidad_Resultado": {
      "type": "string",
      "description": ""
    },
    "Nombre": {
      "type": "string",
      "description": ""
    },
    "Precio": {
      "type": "string",
      "description": ""
    },
    "Promoción": {
      "type": "string",
      "description": ""
    },
    "URL": {
      "type": "string",
      "description": ""
    },
    "Unidad": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Carrefour Spain Listing Scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "ALL": "Super Precio\n\nVer productos\n19,95 €\n3,99 €/l\n\nAceite de oliva virgen extra Maestros de Hojiblanca 5 l.\n\nAgotado\ntemporalmente",
  "Cantidad_Resultado": "5521\nresultados\npara \"aceite\"",
  "Nombre": "Aceite de oliva virgen extra Maestros de Hojiblanca 5 l.",
  "Precio": "19,95 €",
  "Promoción": "Super Precio",
  "URL": "https://www.carrefour.es/supermercado/aceite-de-oliva-virgen-extra-maestros-de-hojiblanca-5-l/R-521033469/p",
  "Unidad": "3,99 €/l"
}
```

Example 2

```json
{
  "ALL": "2ª unidad -50%Ver detalle2ª unidad -50%Compra 2 unidades de este producto y te descontamos el 50% en la 2ª ud. Descuento aplicable sobre el de menor precio. Válido del 10/09/2026 al 23/09/2026.Válido hasta el 23/09/2026CerrarVer productos2,15 €14,33 €/kgChocolate con leche Nestlé Extrafino sin gluten 150 g.Agotado   temporalmente",
  "Cantidad_Resultado": "3239\nresultados\npara \"chocolate\"",
  "Nombre": "Chocolate con leche Nestlé Extrafino sin gluten 150 g.",
  "Precio": "2,15 €",
  "Promoción": "2ª unidad -50%",
  "URL": "https://www.carrefour.es/supermercado/chocolate-con-leche-nestle-extrafino-sin-gluten-150-g/R-VC4AECOMM-463050/p",
  "Unidad": "14,33 €/kg"
}
```

Example 3

```json
{
  "ALL": "2ª unidad -50%Ver detalle2ª unidad -50%Compra 2 unidades de este producto y te descontamos el 50% en la 2ª ud. Descuento aplicable sobre el de menor precio. Válido del 10/09/2026 al 23/09/2026.Válido hasta el 23/09/2026CerrarVer productos2,15 €14,33 €/kgChocolate con leche Nestlé Extrafino sin gluten 150 g.Añadir",
  "Cantidad_Resultado": "3459\nresultados\npara \"chocolate\"",
  "Nombre": "Chocolate con leche Nestlé Extrafino sin gluten 150 g.",
  "Precio": "2,15 €",
  "Promoción": "2ª unidad -50%",
  "URL": "https://www.carrefour.es/supermercado/chocolate-con-leche-nestle-extrafino-sin-gluten-150-g/R-VC4AECOMM-463050/p",
  "Unidad": "14,33 €/kg"
}
```

Example 4

```json
{
  "ALL": "3x2Ver detalle3x2Compra 3 unidades de este producto y paga sólo 2. Descuento aplicable sobre el de menor precio. Válido del 26/08/2026 al 09/09/2026.Válido hasta el 09/09/2026CerrarVer productos1,91 €22,74 €/kgChocolate con leche relleno de cremoso con galleta Nestlé Extrafino Tostarica 84 g.Añadir",
  "Cantidad_Resultado": "3491\nresultados\npara \"chocolate\"",
  "Nombre": "Chocolate con leche relleno de cremoso con galleta Nestlé Extrafino Tostarica 84 g.",
  "Precio": "1,91 €",
  "Promoción": "3x2",
  "URL": "https://www.carrefour.es/supermercado/chocolate-con-leche-relleno-de-cremoso-con-galleta-nestle-extrafino-tostarica-84-g/R-VC4AECOMM-254878/p",
  "Unidad": "22,74 €/kg"
}
```

Example 5

```json
{
  "ALL": "3x2Ver detalle3x2Compra 3 unidades de este producto y paga sólo 2. Descuento aplicable sobre el de menor precio. Válido del 26/08/2026 al 09/09/2026.Válido hasta el 09/09/2026CerrarVer productos1,91 €22,74 €/kgChocolate con leche relleno de cremoso con galleta Nestlé Extrafino Tostarica 84 g.Añadir",
  "Cantidad_Resultado": "3107\nresultados\npara \"chocolate\"",
  "Nombre": "Chocolate con leche relleno de cremoso con galleta Nestlé Extrafino Tostarica 84 g.",
  "Precio": "1,91 €",
  "Promoción": "3x2",
  "URL": "https://www.carrefour.es/supermercado/chocolate-con-leche-relleno-de-cremoso-con-galleta-nestle-extrafino-tostarica-84-g/R-VC4AECOMM-254878/p",
  "Unidad": "22,74 €/kg"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "carrefour-listados-scraper",
  "taskName": "Carrefour Spain Listing Scraper",
  "parameters": "{\"keywords\":[\"chocolate\",\"aceite\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"keywords\":[\"chocolate\",\"aceite\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "carrefour-listados-scraper",
        "taskName": "Carrefour Spain Listing Scraper",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "carrefour-listados-scraper",
  "taskName": "Carrefour Spain Listing Scraper",
  "parameters": "{\"keywords\":[\"chocolate\",\"aceite\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `carrefour-listados-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/carrefour-listados-scraper.json)
- [Manifest](https://www.octoparse.com/templates/carrefour-listados-scraper-manifest.json)