# AutoScout24 Product Listing Scraper

Scrape price, reviews, seller, car status etc. from Auto Scout24 by urls.

- Template page: [https://www.octoparse.com/template/autoscout24-product-listing-scraper](https://www.octoparse.com/template/autoscout24-product-listing-scraper)
- Categories: E-Commerce, Others
- 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 18 fields, including `Anzahl_der_Angebote`, `Anzahl_der_Fahrzeughalter`, `Empfohlener_Grad`, `Erstzulassung`, `Etikett`, `Getriebe`, `Kilometerstand`, `Kraftstoff`, `Kraftstoffverbrauch`, `Kundenbewertung`, `Leistung`, `Preis`, `Produkt_url`, `Seite`, `Standort_des_Verkäufers`, `Titel_des_Produkts`, `Verkäufer`, `Zustand`.

## 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 URLs (up to 10,000), Page numbers (up to 20) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### URLs (up to 10,000)

Required. Enter a list of urls to get information from these listing pages. Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=100000.

### Page numbers (up to 20)

Optional. Enter a number to capture data within a certain number. Constraints: minimum=1, maximum=20.

## How to Use

# AutoScout24 Product Listing Scraper – Usage Guide

Collects listing data from [Autoscout24](https://www.autoscout24.de/) by URLs: price, reviews, seller, car status, and other listing fields displayed on the source pages.

## Input

- **URLs (up to 10,000)** – required. Enter one or more values, one per line. Use specific valid listing or search-result URLs to reduce unrelated or duplicate records.
- **Page numbers (up to 20)** – optional. Enter a number from 1 to 20.

## How to Use

1. Open the template and select **Try it** or **Start**.
2. Complete the input fields.
3. Run locally or in the cloud.
4. Review the returned rows and export or process the structured data.

## Output

Returns listing/search-result fields from each page, including:

- Count of offers and page number
- Product title and product URL
- Price and recommended price grade
- Mileage, first registration, power, fuel, transmission, fuel consumption
- Seller, seller location, customer rating, number of previous owners
- Condition and label

Fields can be empty when the source record does not provide them. The scraper does not add data that Autoscout24 does not display.

## Pricing

No per-line charge currently. Octoparse plan or resource limits may still apply.

## Scheduling and Export

- Schedule runs locally or in the cloud. For local scheduled runs, keep your computer and Octoparse open.
- Export rows to CSV, Excel, JSON, databases, or cloud storage.
- Reuse data 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.

## Tips

- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid URLs (up to 10,000) to avoid unrelated or duplicate records.
- Use a stable URL or identifier as the deduplication key when available.
- Use a detail-page template when you need deeper record data beyond listing/search results.

## Notes

Due to the restriction of the website, we have to limit the number of scraped pages. Therefore, you may scrape a maximum of 20 pages of data. If you want data from more pages, you can contact us.

## 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 Scraper (for Italy)](https://www.octoparse.com/template/crawler-di-autoscout24)
- [AutoScout24 Spain Scraper](https://www.octoparse.com/template/autoscout24-spain-scraper)
- [Google Shopping Product Listing Scraper](https://www.octoparse.com/template/google-shopping-product-listing-scraper)
- [Costco Product Listing Scraper](https://www.octoparse.com/template/costco-product-listing-scraper)
- [Rakuten Product Listing Scraper](https://www.octoparse.com/template/rakuten-product-listing-scraper)

## Input Schema

```json
{
  "title": "AutoScout24 Product Listing Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "uRLs": {
      "title": "URLs (up to 10,000)",
      "description": "Enter a list of urls to get information from these listing pages.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100000
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "page_numbers": {
      "title": "Page numbers (up to 20)",
      "description": "Enter a number to capture data within a certain number.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "uRLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "page_numbers": 5.0,
  "uRLs": [
    "https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU"
  ]
}
```

Example 2

```json
{
  "page_numbers": 5.0,
  "uRLs": [
    "https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU"
  ]
}
```

Example 3

```json
{
  "page_numbers": 5.0,
  "uRLs": [
    "https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU"
  ]
}
```

Example 4

```json
{
  "page_numbers": 5.0,
  "uRLs": [
    "https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU"
  ]
}
```

Example 5

```json
{
  "page_numbers": 5.0,
  "uRLs": [
    "https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU",
    "https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Anzahl_der_Angebote": {
      "type": "string",
      "description": ""
    },
    "Anzahl_der_Fahrzeughalter": {
      "type": "string",
      "description": ""
    },
    "Empfohlener_Grad": {
      "type": "string",
      "description": ""
    },
    "Erstzulassung": {
      "type": "string",
      "description": ""
    },
    "Etikett": {
      "type": "string",
      "description": ""
    },
    "Getriebe": {
      "type": "string",
      "description": ""
    },
    "Kilometerstand": {
      "type": "string",
      "description": ""
    },
    "Kraftstoff": {
      "type": "string",
      "description": ""
    },
    "Kraftstoffverbrauch": {
      "type": "string",
      "description": ""
    },
    "Kundenbewertung": {
      "type": "string",
      "description": ""
    },
    "Leistung": {
      "type": "string",
      "description": ""
    },
    "Preis": {
      "type": "string",
      "description": ""
    },
    "Produkt_url": {
      "type": "string",
      "description": ""
    },
    "Seite": {
      "type": "string",
      "description": ""
    },
    "Standort_des_Verkäufers": {
      "type": "string",
      "description": ""
    },
    "Titel_des_Produkts": {
      "type": "string",
      "description": ""
    },
    "Verkäufer": {
      "type": "string",
      "description": ""
    },
    "Zustand": {
      "type": "string",
      "description": ""
    }
  },
  "title": "AutoScout24 Product 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
{
  "Anzahl_der_Angebote": "874.066",
  "Anzahl_der_Fahrzeughalter": "1",
  "Empfohlener_Grad": "Sehr guter Preis",
  "Erstzulassung": "10/2019",
  "Etikett": "Neu",
  "Getriebe": "Schaltgetriebe",
  "Kilometerstand": "6.745 km",
  "Kraftstoff": "Benzin",
  "Kraftstoffverbrauch": "4,8 l/100 km (komb.)",
  "Kundenbewertung": "5",
  "Leistung": "59 kW (80 PS)",
  "Preis": "€ 10.998",
  "Produkt_url": "https://www.autoscout24.de/angebote/f10ba279-a7c7-4cde-9c3b-341041ded1a5",
  "Seite": "",
  "Standort_des_Verkäufers": "DE-42579 Heiligenhaus",
  "Titel_des_Produkts": "",
  "Verkäufer": "BM Automobile Gbr",
  "Zustand": ""
}
```

Example 2

```json
{
  "Anzahl_der_Angebote": "875.240",
  "Anzahl_der_Fahrzeughalter": "2",
  "Empfohlener_Grad": "Ohne Preisbewertung",
  "Erstzulassung": "05/2013",
  "Etikett": "Neu",
  "Getriebe": "Automatik",
  "Kilometerstand": "119.622 km",
  "Kraftstoff": "Benzin",
  "Kraftstoffverbrauch": "6,3 l/100 km (komb.)",
  "Kundenbewertung": "4,5",
  "Leistung": "141 kW (192 PS)",
  "Preis": "€ 7.999",
  "Produkt_url": "https://www.autoscout24.de/angebote/3ddf8a4d-b502-430e-9b48-b7d437e6a7d1",
  "Seite": "",
  "Standort_des_Verkäufers": "DE-73779 Deizisau",
  "Titel_des_Produkts": "",
  "Verkäufer": "A.K. Automobile GmbH",
  "Zustand": ""
}
```

Example 3

```json
{
  "Anzahl_der_Angebote": "870.608",
  "Anzahl_der_Fahrzeughalter": "1",
  "Empfohlener_Grad": "Ohne Preisbewertung",
  "Erstzulassung": "08/2009",
  "Etikett": "Neu",
  "Getriebe": "Schaltgetriebe",
  "Kilometerstand": "73.958 km",
  "Kraftstoff": "Benzin",
  "Kraftstoffverbrauch": "5,6 l/100 km (komb.)",
  "Kundenbewertung": "4",
  "Leistung": "44 kW (60 PS)",
  "Preis": "€ 2.199",
  "Produkt_url": "https://www.autoscout24.de/angebote/aabaae06-1b71-495d-9f34-5ca03ca39869",
  "Seite": "",
  "Standort_des_Verkäufers": "DE-99734 Nordhausen",
  "Titel_des_Produkts": "",
  "Verkäufer": "Autohandel Werther",
  "Zustand": ""
}
```

Example 4

```json
{
  "Anzahl_der_Angebote": "876.919",
  "Anzahl_der_Fahrzeughalter": "2",
  "Empfohlener_Grad": "Sehr guter Preis",
  "Erstzulassung": "06/2008",
  "Etikett": "Neu",
  "Getriebe": "Schaltgetriebe",
  "Kilometerstand": "209.006 km",
  "Kraftstoff": "Benzin",
  "Kraftstoffverbrauch": "7,4 l/100 km (komb.)",
  "Kundenbewertung": "5",
  "Leistung": "75 kW (102 PS)",
  "Preis": "€ 2.499",
  "Produkt_url": "https://www.autoscout24.de/angebote/fc709d65-b7dd-4990-85ea-fc1bd0b2e6d5",
  "Seite": "",
  "Standort_des_Verkäufers": "DE-52477 Alsdorf",
  "Titel_des_Produkts": "",
  "Verkäufer": "Car-Point Sapmaz",
  "Zustand": ""
}
```

Example 5

```json
{
  "Anzahl_der_Angebote": "872.148",
  "Anzahl_der_Fahrzeughalter": "1",
  "Empfohlener_Grad": "Ohne Preisbewertung",
  "Erstzulassung": "12/2024",
  "Etikett": "Neu",
  "Getriebe": "Automatik",
  "Kilometerstand": "7.471 km",
  "Kraftstoff": "Benzin",
  "Kraftstoffverbrauch": "6,0 l/100 km (komb.)",
  "Kundenbewertung": "4,5",
  "Leistung": "120 kW (163 PS)",
  "Preis": "€ 29.4801",
  "Produkt_url": "https://www.autoscout24.de/angebote/519523e7-2580-4fdf-bbf9-0b8f2cc6600d",
  "Seite": "1",
  "Standort_des_Verkäufers": "DE-14480 Potsdam",
  "Titel_des_Produkts": "",
  "Verkäufer": "STERNAUTO GmbH",
  "Zustand": "Unfallfahrzeug\n\nRepariert"
}
```

## 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-product-listing-scraper",
  "taskName": "AutoScout24 Product Listing Scraper",
  "parameters": "{\"page_numbers\":5.0,\"uRLs\":[\"https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU\",\"https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_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("{\"page_numbers\":5.0,\"uRLs\":[\"https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU\",\"https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_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-product-listing-scraper",
        "taskName": "AutoScout24 Product 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": "autoscout24-product-listing-scraper",
  "taskName": "AutoScout24 Product Listing Scraper",
  "parameters": "{\"page_numbers\":5.0,\"uRLs\":[\"https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_search-mask&ustate=N%2CU\",\"https://www.autoscout24.de/lst?atype=C&cy=D&desc=0&ocs_listing=include&sort=standard&source=homepage_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-product-listing-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-product-listing-scraper.json)
- [Manifest](https://www.octoparse.com/templates/autoscout24-product-listing-scraper-manifest.json)