# Aidl Urls Scraper (`getdataforme/aidl-urls-scraper`) Actor

Extract detailed product data from e-commerce sites like Lidl with Aidl Urls Scraper. Effortlessly scrape titles, prices, descriptions, images, ratings, and more using CheerioCrawler. Ideal for market research, price monitoring, and competitive analysis....

- **URL**: https://apify.com/getdataforme/aidl-urls-scraper.md
- **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community)
- **Categories:** Agents, E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $9.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Aidl Urls Scraper

### Introduction
The Aidl Urls Scraper is a powerful Apify Actor designed to extract detailed product information from e-commerce websites, such as Lidl, by scraping specified URLs. It leverages CheerioCrawler for efficient, headless browsing to gather comprehensive data like prices, descriptions, images, and ratings. This tool is ideal for businesses and researchers needing accurate, structured product data for analysis, monitoring, or integration into workflows.

### Features
- **Efficient Scraping**: Uses CheerioCrawler to handle dynamic web content and extract data from product pages quickly and reliably.
- **Comprehensive Data Extraction**: Captures key product details including title, SKU, brand, price, availability, descriptions, features, images, and customer ratings.
- **Flexible Input**: Accepts a list of start URLs, allowing targeted scraping of specific products or categories.
- **High-Quality Output**: Delivers clean, structured JSON data with consistent formatting for easy integration into databases or applications.
- **Scalable Performance**: Optimized for handling multiple URLs concurrently, with built-in error handling to minimize failures.
- **No Coding Required**: User-friendly interface on Apify Store for easy setup and execution without technical expertise.
- **Reliable and Ethical**: Adheres to web scraping best practices, respecting robots.txt and avoiding overload on target sites.

### Input Parameters

| Parameter | Type | Required | Description | Example |
|-----------|------|----------|-------------|---------|
| startUrls | array | Yes | An array of URLs to start scraping from. Each URL should point to a product page on a supported e-commerce site like Lidl. | `[{"url": "https://www.lidl.de/p/medisana-bauchmuskelguertel-mit-50-intensitaetsstufen/p100383600"}]` |

### Example Usage

#### Input JSON
```json
{
  "startUrls": [
    {
      "url": "https://www.lidl.de/p/medisana-bauchmuskelguertel-mit-50-intensitaetsstufen/p100383600"
    }
  ]
}
````

#### Output JSON

```json
[
  {
    "url": "https://www.lidl.de/p/medisana-bauchmuskelguertel-mit-50-intensitaetsstufen/p100383600",
    "title": "Bauchmuskelgürtel, mit 50 Intensitätstufen | LIDL",
    "sku": "100383600",
    "name": "Bauchmuskelgürtel, mit 50 Intensitätstufen",
    "brand": "MEDISANA",
    "price": 27.99,
    "currency": "EUR",
    "availability": "OnlineOnly",
    "itemCondition": "NewCondition",
    "description": "Anschmiegsame, ergonomische Form Durch flache Bauweise unter der Kleidung tragbar 6 Bauchmuskel-Trainingsprogramme à 30 min wählbar",
    "features": [
      "Anschmiegsame, ergonomische Form Durch flache Bauweise unter der Kleidung tragbar 6 Bauchmuskel-Trainingsprogramme à 30 min wählbar"
    ],
    "imageUrls": [
      "https://www.lidl.de/assets/gcp83a7ab3337684792a14c8c5cff4f015d.jpg",
      "https://www.lidl.de/assets/gcp192e487a9b6f4159b3b2c8a4a0fda8bc.jpg"
    ],
    "rating": {
      "average": 2,
      "count": 4
    }
  }
]
```

### Use Cases

- **Market Research and Analysis**: Gather product data from competitors to analyze pricing trends and market positioning.
- **Competitive Intelligence**: Monitor rival products for features, prices, and availability to inform business strategies.
- **Price Monitoring**: Track price changes on specific items to optimize purchasing or sales decisions.
- **Content Aggregation**: Collect product details for building catalogs, comparison sites, or e-commerce databases.
- **Academic Research**: Extract data for studies on consumer goods, branding, or e-commerce patterns.
- **Business Automation**: Integrate scraped data into workflows for inventory management or automated reporting.

### Installation and Usage

1. Search for "Aidl Urls Scraper" in the Apify Store.
2. Click "Try for free" or "Run".
3. Configure input parameters by providing the list of start URLs.
4. Click "Start" to begin extraction.
5. Monitor progress in the log.
6. Export results in your preferred format (JSON, CSV, Excel).

### Output Format

The Actor outputs a JSON array of objects, each representing a scraped product. Key fields include:

- `url`: The source URL of the product.
- `title`: The full page title.
- `sku`: Unique product identifier.
- `name`: Product name.
- `brand`: Manufacturer or brand name.
- `price`: Numeric price value.
- `currency`: Currency code (e.g., EUR).
- `availability`: Stock status (e.g., OnlineOnly).
- `itemCondition`: Condition (e.g., NewCondition).
- `description`: Detailed product description.
- `features`: Array of key features.
- `imageUrls`: Array of image URLs.
- `rating`: Object with average rating and count.

Data is structured for easy parsing and integration.

### Support

For custom/simplified outputs or bug reports, please contact:

- Email: support@getdataforme.com
- Subject line: "custom support"
- Contact form: https://getdataforme.com/contact/

We're here to help you get the most out of this Actor!

***

### PART 2: Generate Description (Max 300 characters)

Unlock precise product data from e-commerce sites like Lidl with Aidl Urls Scraper. Extract titles, prices, descriptions, images, and ratings effortlessly. Perfect for market research, price monitoring, and competitive analysis. No coding needed—run it on Apify Store today! (148 characters)

# Actor input Schema

## `startUrls` (type: `array`):

URLs to start with.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.lidl.de/p/medisana-bauchmuskelguertel-mit-50-intensitaetsstufen/p100383600#searchTrackingMasterId=Product.100383600"
    }
  ]
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://www.lidl.de/p/medisana-bauchmuskelguertel-mit-50-intensitaetsstufen/p100383600#searchTrackingMasterId=Product.100383600"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("getdataforme/aidl-urls-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "startUrls": [{ "url": "https://www.lidl.de/p/medisana-bauchmuskelguertel-mit-50-intensitaetsstufen/p100383600#searchTrackingMasterId=Product.100383600" }] }

# Run the Actor and wait for it to finish
run = client.actor("getdataforme/aidl-urls-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://www.lidl.de/p/medisana-bauchmuskelguertel-mit-50-intensitaetsstufen/p100383600#searchTrackingMasterId=Product.100383600"
    }
  ]
}' |
apify call getdataforme/aidl-urls-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=getdataforme/aidl-urls-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Aidl Urls Scraper",
        "description": "Extract detailed product data from e-commerce sites like Lidl with Aidl Urls Scraper. Effortlessly scrape titles, prices, descriptions, images, ratings, and more using CheerioCrawler. Ideal for market research, price monitoring, and competitive analysis....",
        "version": "0.0",
        "x-build-id": "BqjJk0jmW3K1NyThI"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/getdataforme~aidl-urls-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-getdataforme-aidl-urls-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/getdataforme~aidl-urls-scraper/runs": {
            "post": {
                "operationId": "runs-sync-getdataforme-aidl-urls-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/getdataforme~aidl-urls-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-getdataforme-aidl-urls-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "startUrls"
                ],
                "properties": {
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "URLs to start with.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
