# Liverpool Listing Scraper

Scrapear información básica de productos (Categoría, Producto, Producto URL, Imagen URL, Precio, Precio original, Color) de Liverpool

- Template page: [https://www.octoparse.com/template/liverpool-listados-scraper](https://www.octoparse.com/template/liverpool-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 `Categoría`, `Color`, `Imagen_URL`, `Precio`, `Precio_original`, `Producto`, `Producto_URL`.

## 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 Palabra(s) clave and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Palabra(s) clave

Required. Palabra(s) clave Constraints: minItems=1; maxItems=100.

## How to Use

# Liverpool Listing Scraper

Collects product categories, names, URLs, images, current prices, original prices, and colors from [Liverpool](https://www.liverpool.com.mx/).

## Input

- **Palabra(s) clave** (required): Enter one or more values, one per line.

## Pricing

This template currently has no per-line charge. Octoparse plan or resource limits may still apply.

## Output

Returns these fields:

- `categoría`
- `producto`
- `producto_URL`
- `imagen_URL`
- `precio`
- `precio_original`
- `color`

## How to Use

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

Run locally or in the cloud. Export rows to CSV, Excel, JSON, databases, or cloud storage, or send them to reporting and AI workflows through Octoparse APIs. Schedule recurring runs, export collected data, and reuse it through Octoparse OpenAPI or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates). Scheduling and API access may require a paid Octoparse plan.

## Limitations

- Collects only the fields listed in Output from listing pages; it does not add data that Liverpool does not display.
- Fields such as `precio`, `precio_original`, and `color` can be empty when the source record does not provide them.

## Tips

- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid Palabra(s) clave to reduce unrelated or duplicate records.
- Use a stable URL or identifier from the returned fields as the deduplication key when available.

For deeper record data, use a detail-page template; this template collects only listing or search-result fields.

## Notes

Si quieres una plantilla personalizada, no dudes en ponerte en contacto con support@octoparse.com.

## 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

- [Liverpool Details Scraper](https://www.octoparse.com/template/liverpool-detalles-scraper)
- [eBay Listing Page Scraper (by keyword)](https://www.octoparse.com/template/ebay-product-list-scraper-by-keyword)
- [Booking.com Hotel Listing Scraper](https://www.octoparse.com/template/booking-com-scraper)
- [Google Maps Store Listing Scraper (Japan)](https://www.octoparse.com/template/google-maps-store-listing-scraper)
- [Zillow Listing Scraper (by URL)](https://www.octoparse.com/template/zillow-scraper)

## Input Schema

```json
{
  "title": "Liverpool Listing Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "palabra_clave": {
      "title": "Palabra(s) clave ",
      "description": "Palabra(s) clave ",
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "palabra_clave"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "palabra_clave": [
    "loro piana"
  ]
}
```

Example 2

```json
{
  "palabra_clave": [
    "loro piana"
  ]
}
```

Example 3

```json
{
  "palabra_clave": [
    "loro piana"
  ]
}
```

Example 4

```json
{
  "palabra_clave": [
    "[\"[\\\"loro piana\\\"]\"]"
  ]
}
```

Example 5

```json
{
  "palabra_clave": [
    "[\"loro piana\"]"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Categoría": {
      "type": "string",
      "description": ""
    },
    "Color": {
      "type": "string",
      "description": ""
    },
    "Imagen_URL": {
      "type": "string",
      "description": ""
    },
    "Precio": {
      "type": "string",
      "description": ""
    },
    "Precio_original": {
      "type": "string",
      "description": ""
    },
    "Producto": {
      "type": "string",
      "description": ""
    },
    "Producto_URL": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Liverpool 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
{
  "Categoría": "Hombre | Liverpool",
  "Color": "",
  "Imagen_URL": "https://sp351.liverpool.com.mx/i/82574247.jpg",
  "Precio": "$974.25",
  "Precio_original": "$1,299.00 ",
  "Producto": "Bata de baño para hombre",
  "Producto_URL": "h/tienda/pdp/bata-de-ba%c3%b1o-para-hombre/1106831293?skuid=82574247"
}
```

Example 2

```json
{
  "Categoría": "Zapatos | Adelanta los deseos",
  "Color": "",
  "Imagen_URL": "https://sp237.liverpool.com.mx/i/1086746057.jpg",
  "Precio": "$699.30",
  "Precio_original": "$999.00 ",
  "Producto": "Zapato choclo para hombre",
  "Producto_URL": "h/tienda/pdp/zapato-choclo-para-hombre/1086746041"
}
```

Example 3

```json
{
  "Categoría": "Zapatos | Adelanta los deseos",
  "Color": "",
  "Imagen_URL": "https://sp237.liverpool.com.mx/i/1175104743.jpg",
  "Precio": "$364.50",
  "Precio_original": "$729.00 ",
  "Producto": "Zapato derby para hombre",
  "Producto_URL": "h/tienda/pdp/zapato-derby-para-hombre/1175104739"
}
```

Example 4

```json
{
  "Categoría": "Zapatos | Liverpool",
  "Color": "",
  "Imagen_URL": "https://sp237.liverpool.com.mx/i/1175104743.jpg",
  "Precio": "$364.50",
  "Precio_original": "$729.00 ",
  "Producto": "Zapato derby para hombre",
  "Producto_URL": "h/tienda/pdp/zapato-derby-para-hombre/1175104739"
}
```

Example 5

```json
{
  "Categoría": "Zapatos | Liverpool",
  "Color": "",
  "Imagen_URL": "https://sp237.liverpool.com.mx/i/1175104743.jpg",
  "Precio": "$364.50",
  "Precio_original": "$729.00 ",
  "Producto": "Zapato derby para hombre",
  "Producto_URL": "h/tienda/pdp/zapato-derby-para-hombre/1175104739"
}
```

## 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": "liverpool-listados-scraper",
  "taskName": "Liverpool Listing Scraper",
  "parameters": "{\"palabra_clave\":[\"loro piana\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"palabra_clave\":[\"loro piana\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "liverpool-listados-scraper",
        "taskName": "Liverpool 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": "liverpool-listados-scraper",
  "taskName": "Liverpool Listing Scraper",
  "parameters": "{\"palabra_clave\":[\"loro piana\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `liverpool-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/liverpool-listados-scraper.json)
- [Manifest](https://www.octoparse.com/templates/liverpool-listados-scraper-manifest.json)
