# Idealo Listing Scraper

Scrape price, url of images, title of the product etc. from Idealo Listing by listing page URLs.

- Template page: [https://www.octoparse.com/template/idealo-listing-scraper](https://www.octoparse.com/template/idealo-listing-scraper)
- Categories: Directories, Lead Generation
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## 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 8 fields, including `Anzahl_von_Angebote`, `Beschreibung`, `Image_url`, `Pagesize`, `Preis`, `Produkt_Titel`, `TrackingLink`, `keyword`.

## 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 Listing page URLs (up to 10000), Number of pages (up to 20) and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Listing page URLs (up to 10000)

Required. https://www.idealo.de/preisvergleich/ProductCategory/16843.html?q=kleid&qd=kleid Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=100000.

### Number of pages (up to 20)

Required. PageSize Constraints: minimum=1, maximum=20.

## How to Use

## Idealo Listing Scraper

Collects price, image URL, title, and other fields from Idealo listing pages.

### Input

- **Listing page URLs (up to 10000)** (required): Enter one or more URLs, one per line.
- **Number of pages (up to 20)** (required): Enter a number from 1 to 20.

### Output

The template returns these fields:

- `Pagesize`
- `keyword`
- `TrackingLink`
- `Image_url`
- `Produkt_Titel`
- `Beschreibung`
- `Anzahl_von_Angebote`
- `Preis`

### How to Use

1. Open the template and select **Try it** or **Start**.
2. Fill in the input fields above.
3. Run the task in the cloud.
4. Review the output rows and export (CSV, Excel, JSON, or via API).

### Limitations

- Only collects data displayed on the listing page; no detail-page data.
- Fields like `Beschreibung`, `Anzahl_von_Angebote`, and `Preis` may be empty if the source record does not provide them.

### Tips

- Start with a few inputs, review results, then scale.
- Use the most specific valid listing URLs to reduce unrelated records.
- Use `TrackingLink` as a deduplication key when available.

### Scheduling & API

- Schedule recurring runs in the cloud. Scheduling may require a paid Octoparse plan.
- Export data via Octoparse OpenAPI or the [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates).

## Notes

The URLs come from the Idealo website. First, enter the keywords into the Idealo search box, then copy the product URLs from the websites and paste them into the Octoparse box. The cookies also come from the website. You can learn this tutorial on how to store and use cookies: Storing and Using Cookies .

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

- [Idealo Details Scraper](https://www.octoparse.com/template/idealo-details-scraper)
- [Idealo Price Comparison Scraper](https://www.octoparse.com/template/idealo-preisvergleich-scraper)
- [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": "Idealo Listing Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "listing_page_URLs": {
      "title": "Listing page URLs  (up to 10000) ",
      "description": "https://www.idealo.de/preisvergleich/ProductCategory/16843.html?q=kleid&qd=kleid",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100000
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "number_of_pages": {
      "title": "Number of pages (up to 20) ",
      "description": "PageSize",
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "listing_page_URLs",
    "number_of_pages"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "listing_page_URLs": [
    "https://www.idealo.de/preisvergleich/ProductCategory/16843.html?q=kleid&qd=kleid"
  ],
  "number_of_pages": 2.0
}
```

Example 2

```json
{
  "listing_page_URLs": [
    "https://www.idealo.de/preisvergleich/ProductCategory/16843.html?q=kleid&qd=kleid"
  ],
  "number_of_pages": 2.0
}
```

Example 3

```json
{
  "listing_page_URLs": [
    "https://www.idealo.de/preisvergleich/ProductCategory/2520F234358.html?q=sony%20kopfh%C3%B6rer&qd=sony%20kopfh%C3%B6rer"
  ],
  "number_of_pages": 2
}
```

Example 4

```json
{
  "listing_page_URLs": [
    "https://www.idealo.de/preisvergleich/ProductCategory/2520F234358.html?q=sony%20kopfh%C3%B6rer&qd=sony%20kopfh%C3%B6rer"
  ],
  "number_of_pages": 3
}
```

Example 5

```json
{
  "listing_page_URLs": [
    "https://www.idealo.de/preisvergleich/MainSearchProductCategory.html?q=spielzeug"
  ],
  "number_of_pages": 3
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Anzahl_von_Angebote": {
      "type": "string",
      "description": ""
    },
    "Beschreibung": {
      "type": "string",
      "description": ""
    },
    "Image_url": {
      "type": "string",
      "description": ""
    },
    "Pagesize": {
      "type": "string",
      "description": ""
    },
    "Preis": {
      "type": "string",
      "description": ""
    },
    "Produkt_Titel": {
      "type": "string",
      "description": ""
    },
    "TrackingLink": {
      "type": "string",
      "description": ""
    },
    "keyword": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Idealo 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_von_Angebote": "4",
  "Beschreibung": "Midikleid, schwarz, Animal-Print, Seide",
  "Image_url": "https://cdn.idealo.com/folder/Product/208606/0/208606032/s1_produktbild_mittelgross/seidensticker-kleid-60-851157-grau.jpg",
  "Pagesize": "1",
  "Preis": "ab 69,59 €",
  "Produkt_Titel": "Seidensticker Kleid (60.851157) grau",
  "TrackingLink": "3e10dc0ef34e16fffc8c09f56d3d96a15a29440e946ac058c7da2b99951b0a131c6c5d44e8133d58f16fbd3d5fc001c28bc1743f405d15e7116b48189eb41f3f22d9c03abb916c978c8de56ea6d746b66d312b97602e69941dcb8b84cd9c1fb0a2a9b07bd66c06eae55ad3958b759764a68aee180775b41ea476dbfacf92ac37",
  "keyword": "kleid"
}
```

Example 2

```json
{
  "Anzahl_von_Angebote": "97",
  "Beschreibung": "Midikleid, Business, Baumwolle",
  "Image_url": "https://cdn.idealo.com/folder/Product/213344/0/213344053/s1_produktbild_mittelgross/marc-o-polo-kleid.jpg",
  "Pagesize": "1",
  "Preis": "ab 90,95 €",
  "Produkt_Titel": "Marc O'Polo Kleid",
  "TrackingLink": "https://www.idealo.de/preisvergleich/OffersOfProduct/213344053_-kleid-marc-o-polo.html",
  "keyword": "kleid"
}
```

Example 3

```json
{
  "Anzahl_von_Angebote": "128",
  "Beschreibung": "Bluetooth-Kopfhörer, Over-Ear, kabellos, kabelgebunden, Apple Siri, Bluetooth 5.2, Frequenzgang 4 - 40.000 Hz, 16 Ohm, 40 h Akkulaufzeit, Schnellladefunktion 10 Minuten für 5 Stunden Laufzeit, Kabellänge 1,2 m, faltbar, aktive Geräuschunterdrückung",
  "Image_url": "https://cdn.idealo.com/folder/Product/201949/7/201949755/s1_produktbild_mittelgross/sony-wh-1000xm5.jpg",
  "Pagesize": "1",
  "Preis": "ab 179,00 €",
  "Produkt_Titel": "Sony WH-1000XM5",
  "TrackingLink": "https://www.idealo.de/preisvergleich/OffersOfProduct/201949755_-wh-1000xm5-sony.html",
  "keyword": "sony kopfhörer"
}
```

Example 4

```json
{
  "Anzahl_von_Angebote": "36",
  "Beschreibung": "Bluetooth-Kopfhörer, Over-Ear, kabellos, Bluetooth 5.2, Frequenzgang 7 - 20.000 Hz, 31 Ohm, 50 h Akkulaufzeit, Kabellänge 1,2 m, aktive Geräuschunterdrückung, mit Freisprechfunktion",
  "Image_url": "https://cdn.idealo.com/folder/Product/202334/7/202334765/s1_produktbild_mittelgross/sony-wh-ch720n-black.jpg",
  "Pagesize": "1",
  "Preis": "ab 58,90 €",
  "Produkt_Titel": "Sony WH-CH720N Black",
  "TrackingLink": "https://www.idealo.de/preisvergleich/OffersOfProduct/202334765_-wh-ch720n-black-sony.html",
  "keyword": "sony kopfhörer"
}
```

Example 5

```json
{
  "Anzahl_von_Angebote": "13",
  "Beschreibung": "Spielzeug Garage, geeignet ab 3 Jahre, Kunststoff, Abmessungen 34 x 68 x 105 cm",
  "Image_url": "https://cdn.idealo.com/folder/Product/203071/5/203071581/s1_produktbild_mittelgross/hot-wheels-city-ultimate-garage-mit-drache-inkl-2-fahrzeuge-hkx48.jpg",
  "Pagesize": "1",
  "Preis": "ab 94,99 €",
  "Produkt_Titel": "Hot Wheels City Ultimate Garage mit Drache Inkl. 2 Fahrzeuge (HKX48)",
  "TrackingLink": "https://www.idealo.de/preisvergleich/OffersOfProduct/203071581_-city-ultimate-garage-mit-drache-inkl-2-fahrzeuge-hkx48-hot-wheels.html",
  "keyword": "spielzeug"
}
```

## 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": "idealo-listing-scraper",
  "taskName": "Idealo Listing Scraper",
  "parameters": "{\"listing_page_URLs\":[\"https://www.idealo.de/preisvergleich/ProductCategory/16843.html?q=kleid&qd=kleid\"],\"number_of_pages\":2.0}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"listing_page_URLs\":[\"https://www.idealo.de/preisvergleich/ProductCategory/16843.html?q=kleid&qd=kleid\"],\"number_of_pages\":2.0}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "idealo-listing-scraper",
        "taskName": "Idealo 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": "idealo-listing-scraper",
  "taskName": "Idealo Listing Scraper",
  "parameters": "{\"listing_page_URLs\":[\"https://www.idealo.de/preisvergleich/ProductCategory/16843.html?q=kleid&qd=kleid\"],\"number_of_pages\":2.0}"
}
JSON
```

## MCP Setup

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