# Wallapop Scraper (by Keywords)

Scrape basic information of products (Product Name; Description; Product URL; Vendor URL; Price etc.)

- Template page: [https://www.octoparse.com/template/wallapop-scraper-palabras-clave](https://www.octoparse.com/template/wallapop-scraper-palabras-clave)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Current price: **$0.3/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required.

## 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 search-results pages, detail pages.

## Output

The current workflow extracts 10 fields, including `descripción`, `detalles`, `envio`, `fecha_pubilicidad`, `imagen_url`, `precio`, `producto`, `producto_url`, `ubicación`, `vendedor_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 Keywords (up to 5000), Number of pages (1-100) and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Keywords (up to 5000)

Required. MainKeys Constraints: minItems=1; maxItems=5000; items.minLength=1; items.maxLength=10000.

### Number of pages (1-100)

Optional. PageSize Constraints: minimum=1, maximum=100.

## How to Use

## Wallapop Scraper (by Keywords)

Collects basic product information from [Wallapop](https://es.wallapop.com/) search results.

### Input

| Parameter | Required | Description |
|-----------|----------|-------------|
| **Keywords (up to 5000)** | Yes | One value per line |
| **Number of pages (1–100)** | No | Integer from 1 to 100 |

### Output Fields

- `producto`
- `detalles`
- `descripción`
- `producto_url`
- `imagen_url`
- `vendedor_url`
- `envio`
- `precio`
- `ubicación`
- `fecha_pubilicidad`

### Pricing

**$0.30 / 1,000 output lines** billed per task.

### How to Use

1. Open the template and click **Try it** or **Start**.
2. Fill in the input fields.
3. Run the task in the cloud.
4. Review the structured output rows. Export as CSV, Excel, JSON, or send via API.

### Limitations

- Collects only data displayed on search result pages. Does not scrape full detail pages.
- Fields like `precio`, `ubicación`, `fecha_pubilicidad` may be empty if the source does not provide them.

### Tips

- Start with a few keywords and review the output before scaling.
- Use specific keywords to reduce unrelated or duplicate records.
- Use `producto_url` as a 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

- [Wallapop Scraper (by Urls)](https://www.octoparse.com/template/wallapop-scraper-con-urls)
- [Google Maps Listings Scraper (by Keywords)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-keyword)
- [Reddit Post Scraper (by Keywords)](https://www.octoparse.com/template/reddit-post-scraper-by-keywords)
- [Google Job Scraper (by Keywords)](https://www.octoparse.com/template/google-job-search)
- [Foursquare Scraper (by Keywords)](https://www.octoparse.com/template/foursquare-scraper-by-keywords)

## Input Schema

```json
{
  "title": "Wallapop Scraper (by Keywords) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "keywords": {
      "title": "Keywords (up to 5000)",
      "description": "MainKeys",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 5000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "number_of_pages": {
      "title": "Number of pages (1-100)",
      "description": "PageSize",
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "keywords"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "keywords": [
    "chaqueta moto",
    "cinturón",
    "bolso"
  ]
}
```

Example 2

```json
{
  "keywords": [
    "chaqueta moto",
    "cinturón",
    "bolso"
  ]
}
```

Example 3

```json
{
  "keywords": [
    "chaqueta moto",
    "cinturón",
    "bolso"
  ]
}
```

Example 4

```json
{
  "keywords": [
    "chaqueta moto",
    "cinturón",
    "bolso"
  ]
}
```

Example 5

```json
{
  "keywords": [
    "chaqueta moto",
    "cinturón",
    "bolso"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "descripción": {
      "type": "string",
      "description": ""
    },
    "detalles": {
      "type": "string",
      "description": ""
    },
    "envio": {
      "type": "string",
      "description": ""
    },
    "fecha_pubilicidad": {
      "type": "string",
      "description": ""
    },
    "imagen_url": {
      "type": "string",
      "description": ""
    },
    "precio": {
      "type": "string",
      "description": ""
    },
    "producto": {
      "type": "string",
      "description": ""
    },
    "producto_url": {
      "type": "string",
      "description": ""
    },
    "ubicación": {
      "type": "string",
      "description": ""
    },
    "vendedor_url": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Wallapop Scraper (by Keywords) 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
{
  "descripción": "Chaqueta de moto de gama media-alta, muy completa y versátil, ideal para viajes largos, rutas trail y uso diario. Construcción de 3 capas, materiales de gran resistencia y un excelente sistema de ventilación.\n3 capas desmontables: exterior de Cordura, membrana impermeable y transpirable HUMAX y chaqueta térmica interior DuPont Cynix, que también puede utilizarse por separado.\nProtección: homologación CE clase AA. Protecciones CE de nivel 2 en hombros y codos y protector de espalda certificado.\nTejidos de alta resistencia: Cordura 500D y 1000D, refuerzos HITENA Ballistic y zonas elásticas para mayor movilidad.",
  "detalles": "Chaqueta de moto de gama media-alta, muy completa y versátil, ideal para viajes largos, rutas trail y uso diario. Construcción de 3 capas, materiales de gran resistencia y un excelente sistema de ventilación.\n3 capas desmontables: exterior de Cordura, membrana impermeable y transpirable HUMAX y chaqueta térmica interior DuPont Cynix, que también puede utilizarse por separado.\nProtección: homologación CE clase AA. Protecciones CE de nivel 2 en hombros y codos y protector de espalda certificado.\nTejidos de alta resistencia: Cordura 500D y 1000D, refuerzos HITENA Ballistic y zonas elásticas para mayor movilidad.",
  "envio": "Entrega en 3 - 7 días",
  "fecha_pubilicidad": "Editado hace 1 día",
  "imagen_url": "https://cdn.wallapop.com/images/10420/ls/c9/__/c10420p1317390523/i6821333045.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/ls/c9/__/c10420p1317390523/i6821333113.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/ls/c9/__/c10420p1317390523/i6821333082.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/ls/c9/__/c10420p1317390523/i6821333106.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/ls/c9/__/c10420p1317390523/i6821333098.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/ls/c9/__/c10420p1317390523/i6821333067.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/ls/c9/__/c10420p1317390523/i6821333121.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/ls/c9/__/c10420p1317390523/i6821333076.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/ls/c9/__/c10420p1317390523/i6821333087.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/ls/c9/__/c10420p1317390523/i6821333060.jpg?pictureSize=W800",
  "precio": "125 EUR",
  "producto": "Chaqueta Moto Rebelhorn Hardy II Talla MChaqueta Moto Rebelhorn Hardy II Talla M",
  "producto_url": "https://es.wallapop.com/item/chaqueta-moto-rebelhorn-hardy-ii-talla-m-1317390523",
  "ubicación": "Móstoles",
  "vendedor_url": "https://es.wallapop.com/app/user/alfonsod-57139129-dqjw2p42kejo"
}
```

Example 2

```json
{
  "descripción": "Cinturon loewe nuevo talla 85cm. Largo 104cm. Sirve para talla 36,38,40 de pantalon. ",
  "detalles": "Cinturon loewe nuevo talla 85cm. Largo 104cm. Sirve para talla 36,38,40 de pantalon.",
  "envio": "Entrega en 3 - 7 días",
  "fecha_pubilicidad": "Editado hace 1 día",
  "imagen_url": "https://cdn.wallapop.com/images/10420/lk/0o/__/c10420p1303414094/i6739158746.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lk/0o/__/c10420p1303414094/i6739158760.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lk/0o/__/c10420p1303414094/i6739158775.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lk/0o/__/c10420p1303414094/i6739158752.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lk/0o/__/c10420p1303414094/i6739158765.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lk/0o/__/c10420p1303414094/i6739158771.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lk/0o/__/c10420p1303414094/i6739158756.jpg?pictureSize=W800",
  "precio": "160 EUR",
  "producto": "Cinturon loeweCinturon loewe",
  "producto_url": "https://es.wallapop.com/item/cinturon-loewe-1303414094",
  "ubicación": "Madrid",
  "vendedor_url": "https://es.wallapop.com/app/user/marcosr-51304129-dqjwr1845e6o"
}
```

Example 3

```json
{
  "descripción": "Bolso Longchamp con un diseño atemporal y versátil, ideal para el uso diario.\n\n- Cuerpo en tono azul oscuro.\n- Detalles en piel marrón.\n- Cierre con cremallera y solapa con botón a presión.",
  "detalles": "Bolso Longchamp con un diseño atemporal y versátil, ideal para el uso diario.\n\n- Cuerpo en tono azul oscuro.\n- Detalles en piel marrón.\n- Cierre con cremallera y solapa con botón a presión.",
  "envio": "Entrega en 3 - 7 días",
  "fecha_pubilicidad": "Editado hace 1 día",
  "imagen_url": "https://cdn.wallapop.com/images/10420/lu/m8/__/c10420p1321215777/i6848460205.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lu/m8/__/c10420p1321215777/i6848460241.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lu/m8/__/c10420p1321215777/i6848460214.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lu/m8/__/c10420p1321215777/i6848460218.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lu/m8/__/c10420p1321215777/i6848460231.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lu/m8/__/c10420p1321215777/i6848460227.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lu/m8/__/c10420p1321215777/i6848460222.jpg?pictureSize=W800",
  "precio": "40 EUR",
  "producto": "Bolso Longchamp Azul y MarrónBolso Longchamp Azul y Marrón",
  "producto_url": "https://es.wallapop.com/item/bolso-longchamp-azul-y-marron-1321215777",
  "ubicación": "Madrid",
  "vendedor_url": "https://es.wallapop.com/app/user/adrianv-16892761-npj9yyo82k6e"
}
```

Example 4

```json
{
  "descripción": "Chaqueta estilo aviador de Zara con forro interior de borreguillo en tono claro. Presenta un diseño atemporal con detalles en contraste.\n\n- Cierre frontal con cremallera.\n- Cinturón ajustable en el bajo.\n- Bolsillos laterales con cremallera.",
  "detalles": "Chaqueta estilo aviador de Zara con forro interior de borreguillo en tono claro. Presenta un diseño atemporal con detalles en contraste.\n\n- Cierre frontal con cremallera.\n- Cinturón ajustable en el bajo.\n- Bolsillos laterales con cremallera.",
  "envio": "Entrega en 3 - 7 días",
  "fecha_pubilicidad": "Editado hace 1 día",
  "imagen_url": "https://cdn.wallapop.com/images/10420/lv/5b/__/c10420p1322106120/i6853799904.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lv/5b/__/c10420p1322106120/i6853799914.jpg?pictureSize=W800;https://cdn.wallapop.com/images/10420/lv/5b/__/c10420p1322106120/i6853799912.jpg?pictureSize=W800",
  "precio": "25 EUR",
  "producto": "Chaqueta Abrigo Aviador ZaraChaqueta Abrigo Aviador Zara",
  "producto_url": "https://es.wallapop.com/item/chaqueta-abrigo-aviador-zara-1322106120",
  "ubicación": "Madrid",
  "vendedor_url": "https://es.wallapop.com/app/user/alejandrag-47407204-4w674m17yy6x"
}
```

Example 5

```json
{
  "descripción": "Bolso de mano en color beige con diseño estructurado y acabado texturizado.\n\n- Medidas: 14x24 cm.\n- Incluye asa bandolera ajustable con logo.\n- Detalle de colgante con forma de oso.\n- Asas superiores con nudos decorativos.",
  "detalles": "Bolso de mano en color beige con diseño estructurado y acabado texturizado.\n\n- Medidas: 14x24 cm.\n- Incluye asa bandolera ajustable con logo.\n- Detalle de colgante con forma de oso.\n- Asas superiores con nudos decorativos.",
  "envio": "Entrega en 3 - 7 días",
  "fecha_pubilicidad": "Editado hace 1 día",
  "imagen_url": "https://cdn.wallapop.com/images/10420/lv/ik/__/c10420p1322724338/i6856969214.jpg?pictureSize=W800",
  "precio": "40 EUR",
  "producto": "Bolso Tous Beige 14x24 cmBolso Tous Beige 14x24 cm",
  "producto_url": "https://es.wallapop.com/item/bolso-tous-beige-14x24-cm-1322724338",
  "ubicación": "Parla",
  "vendedor_url": "https://es.wallapop.com/app/user/antonioa-13125812-v9jdxq1vllzk"
}
```

## 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": "wallapop-scraper-palabras-clave",
  "taskName": "Wallapop Scraper (by Keywords)",
  "parameters": "{\"keywords\":[\"chaqueta moto\",\"cinturón\",\"bolso\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"keywords\":[\"chaqueta moto\",\"cinturón\",\"bolso\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "wallapop-scraper-palabras-clave",
        "taskName": "Wallapop Scraper (by Keywords)",
        "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": "wallapop-scraper-palabras-clave",
  "taskName": "Wallapop Scraper (by Keywords)",
  "parameters": "{\"keywords\":[\"chaqueta moto\",\"cinturón\",\"bolso\"]}"
}
JSON
```

## MCP Setup

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