# Autoscout24 Listings ULRs Scraper (`alkausari_mujahid/autoscout24-listings-urls-scraper`) Actor

Scrape listing URLs from AutoScout24 search results across all pages. Pair with alkausari\_mujahid/autoscout24-details-scraper to extract full car details faster from the collected URLs.

- **URL**: https://apify.com/alkausari\_mujahid/autoscout24-listings-urls-scraper.md
- **Developed by:** [Alkausari M](https://apify.com/alkausari_mujahid) (community)
- **Categories:** Automation, Integrations, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.00005 / actor start

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

## AutoScout24 Listings URLs Scraper

**Collect every car listing URL from any [AutoScout24](https://www.autoscout24.com) search — no coding required.** Apply your filters directly on AutoScout24, paste the search URL here, and get a clean dataset of listing URLs. Use it together with [alkausari_mujahid/autoscout24-details-scraper](https://apify.com/alkausari_mujahid/autoscout24-details-scraper) to extract full car details faster from the collected URLs.

### What does AutoScout24 Listings URLs Scraper do?

This Actor visits AutoScout24 search result pages and extracts the URL of every car listing that matches your filters. It follows pagination automatically, so you get results from every page — not just the first one. Output is a simple dataset of URLs you can download, feed into another Actor, or integrate via the Apify API.

### Why use AutoScout24 Listings URLs Scraper?

- **Market research** — monitor which cars are available in a specific region, make, model, or price range.
- **Price tracking** — collect listing URLs daily and feed them into a detail scraper to track price changes over time.
- **Lead generation** — dealers and brokers can monitor new listings that match specific criteria.
- **Data pipelines** — use as the first stage in a two-Actor pipeline: collect URLs here, scrape details in a second Actor.
- **No-code friendly** — no developer skills needed; configure everything from the Apify Console input form.

### How to use AutoScout24 Listings URLs Scraper

1. Go to [AutoScout24](https://www.autoscout24.com) and apply your desired filters (make, model, price, year, country, etc.).
2. Copy the URL from your browser's address bar once the results are showing.
3. Open this Actor in the [Apify Console](https://console.apify.com) and paste the URL into **Start URLs**.
4. *(Optional)* Set **Max requests per crawl** to limit how many pages are visited.
5. *(Optional)* Enable **Proxy configuration** — Residential proxies are recommended for reliable results.
6. Click **Start** and wait for the run to finish. Results appear in the **Output** tab.

### Input

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `startUrls` | array | Yes | — | One or more AutoScout24 search page URLs |
| `maxRequestsPerCrawl` | integer | No | `200` | Max pages to visit (0 = unlimited) |
| `delayMs` | integer | No | `1500` | Wait time in ms after scrolling before extracting links |
| `proxyConfiguration` | object | No | No proxy | Proxy settings — Residential proxies recommended |

**Example input:**

```json
{
  "startUrls": [
    { "url": "https://www.autoscout24.com/lst/bmw/3er?sort=age&desc=0&cy=D" }
  ],
  "maxRequestsPerCrawl": 50,
  "delayMs": 1500,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}
````

### Output

Each item in the dataset is a single listing URL:

```json
[
  { "url": "https://www.autoscout24.com/offers/bmw-320d-touring-diesel-blue-2023-123456789-abc" },
  { "url": "https://www.autoscout24.com/offers/bmw-318i-limousine-petrol-white-2022-987654321-xyz" }
]
```

You can download the dataset in various formats such as **JSON, CSV, Excel, or HTML** from the **Storage** tab of your run.

### Data table

| Field | Format | Description |
|---|---|---|
| `url` | string | Canonical AutoScout24 listing URL |

### Pricing / Cost estimation

This Actor is billed by **compute units (CU)**. A typical run scraping 20 listing pages (≈ 400 URLs) consumes roughly **0.05–0.1 CU**, which is well within the [Apify Free plan](https://apify.com/pricing) limits.

Factors that affect cost:

- Number of search result pages (pagination depth)
- Use of Residential proxies (recommended but adds proxy bandwidth cost)
- `delayMs` setting — higher values slow the run but reduce bot-detection risk

To minimise cost, set `maxRequestsPerCrawl` to limit pagination depth when you only need recent listings.

### Tips

- **Use specific search URLs** — apply all your filters on AutoScout24 first (make, model, year, fuel type, country) before copying the URL. The more specific the search, the fewer pages to scrape.
- **Multiple searches** — add several search URLs in one run (e.g. different makes or countries) to collect all results in a single dataset.
- **Scheduling** — use [Apify Scheduler](https://docs.apify.com/platform/schedules) to run this Actor daily and always have a fresh list of listings.
- **Proxy** — if you see bot-detection warnings in the logs, enable Residential proxies in the proxy configuration.
- **Pipeline** — feed this Actor's dataset directly into [alkausari\_mujahid/autoscout24-details-scraper](https://apify.com/alkausari_mujahid/autoscout24-details-scraper) as its `startUrls` to extract full car details faster.

### FAQ, disclaimers, and support

**Is scraping AutoScout24 legal?**
Web scraping publicly available data is generally legal in most jurisdictions, but you should always review [AutoScout24's Terms of Service](https://www.autoscout24.com/terms) before use. This Actor is intended for personal research, academic, and legitimate business use only. Do not use it to harvest personal data or violate the platform's ToS.

**Why are some listings missing?**
AutoScout24 may show a different number of results to automated browsers vs. real users. Enabling Residential proxies and increasing `delayMs` typically resolves this.

**The Actor is blocked / CAPTCHA errors.**
Enable Residential proxies in the proxy configuration and retry. If the problem persists, increase `delayMs`.

**I need to extract full car details, not just URLs.**
Use [alkausari\_mujahid/autoscout24-details-scraper](https://apify.com/alkausari_mujahid/autoscout24-details-scraper) — it accepts the output of this Actor as input and scrapes price, mileage, specs, images, and dealer info for each listing.

**I need custom features.**
Open an issue in the [Issues tab](../../issues) of this Actor on Apify Store, or contact the author for a custom solution.

# Actor input Schema

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

One or more AutoScout24 search URLs to scrape. Supported domains: autoscout24.com, autoscout24.de, autoscout24.it.

## `maxRequestsPerCrawl` (type: `integer`):

Maximum number of pages to visit across all pagination. Set to 0 for unlimited.

## `delayMs` (type: `integer`):

Milliseconds to wait after scrolling before extracting links. Helps avoid bot detection.

## `proxyConfiguration` (type: `object`):

Proxy settings used to avoid bot detection. Apify Residential proxies are recommended.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.autoscout24.com/lst/audi?atype=C&body=3&cy=D%2CA%2CB%2CE%2CF%2CI%2CL%2CNL&damaged_listing=exclude&desc=0&fregfrom=2026&powertype=kw&search_id=1zkva57zj25&sort=standard&source=listpage_pagination&ustate=N%2CU"
    }
  ],
  "maxRequestsPerCrawl": 10,
  "delayMs": 1500,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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.autoscout24.com/lst/audi?atype=C&body=3&cy=D%2CA%2CB%2CE%2CF%2CI%2CL%2CNL&damaged_listing=exclude&desc=0&fregfrom=2026&powertype=kw&search_id=1zkva57zj25&sort=standard&source=listpage_pagination&ustate=N%2CU"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("alkausari_mujahid/autoscout24-listings-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.autoscout24.com/lst/audi?atype=C&body=3&cy=D%2CA%2CB%2CE%2CF%2CI%2CL%2CNL&damaged_listing=exclude&desc=0&fregfrom=2026&powertype=kw&search_id=1zkva57zj25&sort=standard&source=listpage_pagination&ustate=N%2CU" }],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("alkausari_mujahid/autoscout24-listings-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.autoscout24.com/lst/audi?atype=C&body=3&cy=D%2CA%2CB%2CE%2CF%2CI%2CL%2CNL&damaged_listing=exclude&desc=0&fregfrom=2026&powertype=kw&search_id=1zkva57zj25&sort=standard&source=listpage_pagination&ustate=N%2CU"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call alkausari_mujahid/autoscout24-listings-urls-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Autoscout24 Listings ULRs Scraper",
        "description": "Scrape listing URLs from AutoScout24 search results across all pages. Pair with alkausari_mujahid/autoscout24-details-scraper to extract full car details faster from the collected URLs.",
        "version": "0.0",
        "x-build-id": "lUNU109qgsnv4TIOD"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/alkausari_mujahid~autoscout24-listings-urls-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-alkausari_mujahid-autoscout24-listings-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/alkausari_mujahid~autoscout24-listings-urls-scraper/runs": {
            "post": {
                "operationId": "runs-sync-alkausari_mujahid-autoscout24-listings-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/alkausari_mujahid~autoscout24-listings-urls-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-alkausari_mujahid-autoscout24-listings-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": "One or more AutoScout24 search URLs to scrape. Supported domains: autoscout24.com, autoscout24.de, autoscout24.it.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "maxRequestsPerCrawl": {
                        "title": "Max Requests Per Crawl",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of pages to visit across all pagination. Set to 0 for unlimited.",
                        "default": 10
                    },
                    "delayMs": {
                        "title": "Delay between actions (ms)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Milliseconds to wait after scrolling before extracting links. Helps avoid bot detection.",
                        "default": 1500
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings used to avoid bot detection. Apify Residential proxies are recommended.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```