# AutoScout24 Spain Scraper

Extract car information from AutoScout24 Spain

- Template page: [https://www.octoparse.com/template/autoscout24-spain-scraper](https://www.octoparse.com/template/autoscout24-spain-scraper)
- Categories: E-Commerce, Lead Generation
- 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 general web pages.

## Output

The current workflow extracts 16 fields, including `Año`, `Combustible`, `Descripcion`, `Dirección_del_distribuidor`, `Distribuidor`, `Img_url`, `Kilometraje`, `Marca`, `Modelo`, `Pagina_URL`, `Phone_Number`, `Potencia`, `Precio`, `Preio_Nivel`, `Source_URL`, `Tipo_de_cambio`.

## 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 Enter URLs of Search Results(each URL/line) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Enter URLs of Search Results(each URL/line)

Required. URL of Search Results Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=10000.

## How to Use

# AutoScout24 Spain Scraper

Collects car listing data from [AutoScout24 Spain](https://www.autoscout24.es/). This template is free of charge (no per-line fee).

## Input

- **Enter URLs of Search Results (each URL/line)** (required): One or more search result page URLs, one per line.

## Output

Each row contains the following fields:

- `Source_URL`
- `Marca`
- `Modelo`
- `Pagina_URL`
- `Descripcion`
- `Precio`
- `Preio_Nivel`
- `Kilometraje`
- `Año`
- `Combustible`
- `Potencia`
- `Distribuidor`
- `Dirección_del_distribuidor`
- `Img_url`
- `Phone_Number`
- `Tipo_de_cambio`

## How to Use

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

## Limitations

- Collects data from search result pages only; does not retrieve details not displayed by AutoScout24.
- Fields like `Img_url`, `Phone_Number`, and `Tipo_de_cambio` may be empty if the source listing does not provide them.

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

- [AutoScout24 Product Listing Scraper](https://www.octoparse.com/template/autoscout24-product-listing-scraper)
- [AutoScout24 Scraper (for Italy)](https://www.octoparse.com/template/crawler-di-autoscout24)
- [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)

## Input Schema

```json
{
  "title": "AutoScout24 Spain Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "enter_URLs_of_Search_Results": {
      "title": "Enter URLs of Search Results(each URL/line)",
      "description": "URL of Search Results",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "enter_URLs_of_Search_Results"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "enter_URLs_of_Search_Results": [
    "https://www.autoscout24.es/lst?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\\nhttps://www.autoscout24.es/lst/porsche?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.es/lst/ford?atype=C&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=1itigwkkztc&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.es/lst?atype=C&body=5&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=2g7saptt027&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU"
  ]
}
```

Example 2

```json
{
  "enter_URLs_of_Search_Results": [
    "https://www.autoscout24.es/lst?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\\nhttps://www.autoscout24.es/lst/porsche?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.es/lst/ford?atype=C&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=1itigwkkztc&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.es/lst?atype=C&body=5&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=2g7saptt027&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU"
  ]
}
```

Example 3

```json
{
  "enter_URLs_of_Search_Results": [
    "https://www.autoscout24.es/lst?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\\nhttps://www.autoscout24.es/lst/porsche?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.es/lst/ford?atype=C&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=1itigwkkztc&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.es/lst?atype=C&body=5&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=2g7saptt027&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU"
  ]
}
```

Example 4

```json
{
  "enter_URLs_of_Search_Results": [
    "https://www.autoscout24.es/lst?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\\nhttps://www.autoscout24.es/lst/porsche?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.es/lst/ford?atype=C&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=1itigwkkztc&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.es/lst?atype=C&body=5&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=2g7saptt027&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Año": {
      "type": "string",
      "description": ""
    },
    "Combustible": {
      "type": "string",
      "description": ""
    },
    "Descripcion": {
      "type": "string",
      "description": ""
    },
    "Dirección_del_distribuidor": {
      "type": "string",
      "description": ""
    },
    "Distribuidor": {
      "type": "string",
      "description": ""
    },
    "Img_url": {
      "type": "string",
      "description": ""
    },
    "Kilometraje": {
      "type": "string",
      "description": ""
    },
    "Marca": {
      "type": "string",
      "description": ""
    },
    "Modelo": {
      "type": "string",
      "description": ""
    },
    "Pagina_URL": {
      "type": "string",
      "description": ""
    },
    "Phone_Number": {
      "type": "string",
      "description": ""
    },
    "Potencia": {
      "type": "string",
      "description": ""
    },
    "Precio": {
      "type": "string",
      "description": ""
    },
    "Preio_Nivel": {
      "type": "string",
      "description": ""
    },
    "Source_URL": {
      "type": "string",
      "description": ""
    },
    "Tipo_de_cambio": {
      "type": "string",
      "description": ""
    }
  },
  "title": "AutoScout24 Spain 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
{
  "Año": "",
  "Combustible": "",
  "Descripcion": "",
  "Dirección_del_distribuidor": "",
  "Distribuidor": "",
  "Img_url": "",
  "Kilometraje": "",
  "Marca": "",
  "Modelo": "",
  "Pagina_URL": "",
  "Phone_Number": "",
  "Potencia": "",
  "Precio": "",
  "Preio_Nivel": "",
  "Source_URL": "https://www.autoscout24.es/lst?cy=E&desc=0&sort=standard&ustate=N&atype=C&source=homepage_search-mask",
  "Tipo_de_cambio": ""
}
```

Example 2

```json
{
  "Año": "",
  "Combustible": "",
  "Descripcion": "",
  "Dirección_del_distribuidor": "",
  "Distribuidor": "",
  "Img_url": "",
  "Kilometraje": "",
  "Marca": "",
  "Modelo": "",
  "Pagina_URL": "",
  "Phone_Number": "",
  "Potencia": "",
  "Precio": "",
  "Preio_Nivel": "",
  "Source_URL": "https://www.autoscout24.es/lst/bt_familiar?cy=E&damaged_listing=exclude&desc=0&powertype=kw&sort=standard&ustate=N%2CU&atype=C&search_id=2g7saptt027&source=homepage_search-mask%2Chomepage_search-mask",
  "Tipo_de_cambio": ""
}
```

Example 3

```json
{
  "Año": "",
  "Combustible": "",
  "Descripcion": "",
  "Dirección_del_distribuidor": "",
  "Distribuidor": "",
  "Img_url": "",
  "Kilometraje": "",
  "Marca": "",
  "Modelo": "",
  "Pagina_URL": "",
  "Phone_Number": "",
  "Potencia": "",
  "Precio": "",
  "Preio_Nivel": "",
  "Source_URL": "https://www.autoscout24.es/lst?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\\nhttps://www.autoscout24.es/lst/porsche?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU",
  "Tipo_de_cambio": ""
}
```

Example 4

```json
{
  "Año": "02/2023",
  "Combustible": "Electro/Gasolina",
  "Descripcion": "ABS, Airbags laterales, Faros antiniebla",
  "Dirección_del_distribuidor": "ES-41007 SEVILLA",
  "Distribuidor": "CONQUERO OCASION",
  "Img_url": "https://prod.pictures.autoscout24.net/listing-images/f3dc163d-849e-42df-839d-bfe981eb4bd2_dfea1754-29c8-4e7b-9dde-d3ab574cf446.jpg/250x188.webp",
  "Kilometraje": "17.021 km",
  "Marca": "Nissan Juke",
  "Modelo": " 1.6 Hybrid Tekna Auto ",
  "Pagina_URL": "https://www.autoscout24.es/anuncios/f3dc163d-849e-42df-839d-bfe981eb4bd2",
  "Phone_Number": "+34 - 854683822",
  "Potencia": "105 kW (143 CV)",
  "Precio": "€ 1",
  "Preio_Nivel": "Sin comparación",
  "Source_URL": "https://www.autoscout24.es/lst?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\\nhttps://www.autoscout24.es/lst/porsche?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU",
  "Tipo_de_cambio": "Automático"
}
```

## 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": "autoscout24-spain-scraper",
  "taskName": "AutoScout24 Spain Scraper",
  "parameters": "{\"enter_URLs_of_Search_Results\":[\"https://www.autoscout24.es/lst?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\\\\nhttps://www.autoscout24.es/lst/porsche?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\",\"https://www.autoscout24.es/lst/ford?atype=C&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=1itigwkkztc&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU\",\"https://www.autoscout24.es/lst?atype=C&body=5&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=2g7saptt027&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"enter_URLs_of_Search_Results\":[\"https://www.autoscout24.es/lst?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\\\\nhttps://www.autoscout24.es/lst/porsche?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\",\"https://www.autoscout24.es/lst/ford?atype=C&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=1itigwkkztc&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU\",\"https://www.autoscout24.es/lst?atype=C&body=5&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=2g7saptt027&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "autoscout24-spain-scraper",
        "taskName": "AutoScout24 Spain 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": "autoscout24-spain-scraper",
  "taskName": "AutoScout24 Spain Scraper",
  "parameters": "{\"enter_URLs_of_Search_Results\":[\"https://www.autoscout24.es/lst?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\\\\nhttps://www.autoscout24.es/lst/porsche?atype=C&cy=E&desc=0&sort=standard&source=homepage_search-mask&ustate=N%2CU\",\"https://www.autoscout24.es/lst/ford?atype=C&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=1itigwkkztc&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU\",\"https://www.autoscout24.es/lst?atype=C&body=5&cy=E&damaged_listing=exclude&desc=0&powertype=kw&search_id=2g7saptt027&sort=standard&source=homepage_search-mask%2Chomepage_search-mask&ustate=N%2CU\"]}"
}
JSON
```

## MCP Setup

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