# Autoplac Automotive Search Scraper (`stealth_mode/autoplac-automotive-search-scraper`) Actor

Scrape detailed vehicle listings from Autoplac.pl, Poland's largest auto marketplace. Extract 44+ fields including brand, model, price, mileage, engine specs, location, and seller details — perfect for market research, price monitoring, and inventory analysis.

- **URL**: https://apify.com/stealth\_mode/autoplac-automotive-search-scraper.md
- **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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/docs.md):

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

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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

## Autoplac.pl Automotive Scraper: Collect Polish Car Listing Data at Scale
---

### What Is Autoplac.pl?

Autoplac.pl is Poland's leading online automotive marketplace, hosting hundreds of thousands of personal and commercial vehicle listings. The platform aggregates cars from private sellers, dealers, and leasing companies across all Polish regions. Collecting structured data from Autoplac manually is inefficient — the **Autoplac Automotive Scraper** extracts comprehensive vehicle details in seconds, delivering clean, actionable data for competitive analysis and market insights.

---

### Overview

The **Autoplac Automotive Scraper** harvests detailed vehicle records from Autoplac.pl listing pages, converting unstructured marketplace data into structured datasets. It is designed for:

- **Car dealers** monitoring competitor inventory and pricing strategies
- **Price analysts** tracking market trends and valuation benchmarks
- **Researchers** studying the Polish automotive market
- **Aggregator platforms** building multi-source vehicle databases
- **Investors** assessing market opportunities in the automotive sector

Key strengths include extraction of 44+ vehicle attributes, support for bulk URL scraping, automatic failure handling, and configurable item limits to control data volume.

---

### Input Format

The scraper accepts a JSON configuration object specifying which Autoplac listing pages to target:

```json
{
  "urls": [
    "https://autoplac.pl/oferty/samochody-osobowe?p=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

| Field | Type | Description |
|---|---|---|
| `urls` | Array of strings | Direct links to Autoplac search or category pages (e.g., personal cars, page 2). Supports multiple URLs for bulk collection. |
| `max_items_per_url` | Integer | Maximum number of vehicles to extract per URL. Default is 20; increase to 200 for full-page collection. |
| `ignore_url_failures` | Boolean | If `true`, the scraper skips failed URLs and continues; if `false`, the run stops on errors. |

> **Tip:** Use filtered category URLs (e.g., "personal cars," "page 2") to focus on specific vehicle types or regions. The scraper handles pagination automatically.

***

### Output Format

**Sample output**

```json
{
  "user_id": 1591732,
  "id": 3931265,
  "brand": "Volkswagen",
  "model": "T-Roc",
  "generation": "Inny",
  "version": "Inny",
  "brand_id": 582,
  "model_id": 5515,
  "production_year": 2024,
  "mileage": 10221,
  "engine_power_kw": null,
  "engine_capacity": 1498,
  "seats": 5,
  "body_type": "SUV",
  "body_type_text": "SUV",
  "fuel_type": "GASOLINE",
  "fuel_type_text": "Benzyna",
  "drive_type_text": "Napęd na przednią oś",
  "vin_available": true,
  "transmission_type_text": "Automatyczna",
  "loan_source_info": {
    "value": "COMPERIA",
    "logo_url": "https://autoplac-public-bucket.s3.eu-west-1.amazonaws.com/frontend-assets/logos/comperia_white_240x84.png",
    "calculator_enabled": true,
    "max_amount": 300000,
    "min_amount": 1000,
    "max_loan_months": 84,
    "min_loan_months": 3,
    "initial_loan_months": 84,
    "representative_example": "Powyższe dane są symulacją niestanowiąca oferty handlowej. Przykład reprezentatywny dla pożyczki konsumenckiej: Rzeczywista roczna stopa oprocentowania (RRSO) wynosi 31,36%, całkowita kwota kredytu (bez kredytowanych kosztów) 9 704,24 zł, oprocentowanie zmienne 9,5% w skali roku, całkowity koszt kredytu 6 115,65 zł (w tym: prowizja 3 512,93 zł, odsetki 2 602,72 zł), całkowita kwota do zapłaty 15 819,89 zł płatna w 46 ratach miesięcznych (w tym 45 miesięcznych równych rat w wysokości po 343,94 zł, ostatnia rata: 342,59 zł). Kalkulacja na dzień 04.11.2021 r. Wyliczenie szacunkowej raty służy jedynie orientacyjnemu określeniu wysokości raty, nie jest wiążące prawnie i nie stanowi oferty w rozumieniu ustawy z dnia 23 kwietnia 1964 r. Kodeks cywilny (t.j. Dz. U. z 2018 r. poz. 1025 z późn. zm.).",
    "loan_installment": 1956,
    "loan_r_r_s_o": 8.46,
    "financing_links": {
      "yanosik": "https://form.comperia.pl/autoplac_mobile_pok_k1?utm_source=autoplac.pl&utm_medium=display&utm_campaign=kredyty_gotowkowe&utm_content=default-content-tag&utm_term=default-term-tag&price=124900&pozyczka=124900&title=Volkswagen+T-Roc&img=https%3A%2F%2Feuw2-cdn.autoplac.pl%2Fv1%2Fp%2F13a1dcf7-b9e1-4ffc-9a03-bcb04862bf61&brand=Volkswagen&model=T-Roc&link=https%3A%2F%2Fautoplac.pl%2Foferta%2Fvolkswagen%2Ft-roc%2F1-5-2024r-3464-9420-ZN&repayment-term=84&okres=84&rata_kg=1956&rrso=8.46",
      "app": "https://form.comperia.pl/autoplac_mobile_pok_k1?utm_source=autoplac.pl&utm_medium=display&utm_campaign=kredyty_gotowkowe&utm_content=default-content-tag&utm_term=default-term-tag&price=124900&pozyczka=124900&title=Volkswagen+T-Roc&img=https%3A%2F%2Feuw2-cdn.autoplac.pl%2Fv1%2Fp%2F13a1dcf7-b9e1-4ffc-9a03-bcb04862bf61&brand=Volkswagen&model=T-Roc&link=https%3A%2F%2Fautoplac.pl%2Foferta%2Fvolkswagen%2Ft-roc%2F1-5-2024r-3464-9420-ZN&repayment-term=84&okres=84&rata_kg=1956&rrso=8.46",
      "web": {
        "mobile": "https://form.comperia.pl/autoplac_mobile_pok_k1?utm_source=autoplac.pl&utm_medium=display&utm_campaign=kredyty_gotowkowe&utm_content=default-content-tag&utm_term=default-term-tag&price=124900&pozyczka=124900&title=Volkswagen+T-Roc&img=https%3A%2F%2Feuw2-cdn.autoplac.pl%2Fv1%2Fp%2F13a1dcf7-b9e1-4ffc-9a03-bcb04862bf61&brand=Volkswagen&model=T-Roc&link=https%3A%2F%2Fautoplac.pl%2Foferta%2Fvolkswagen%2Ft-roc%2F1-5-2024r-3464-9420-ZN&repayment-term=84&okres=84&rata_kg=1956&rrso=8.46",
        "desktop": "https://form.comperia.pl/autoplac_desktop_pok_k1?utm_source=autoplac.pl&utm_medium=display&utm_campaign=kredyty_gotowkowe&utm_content=default-content-tag&utm_term=default-term-tag&price=124900&pozyczka=124900&title=Volkswagen+T-Roc&img=https%3A%2F%2Feuw2-cdn.autoplac.pl%2Fv1%2Fp%2F13a1dcf7-b9e1-4ffc-9a03-bcb04862bf61&brand=Volkswagen&model=T-Roc&link=https%3A%2F%2Fautoplac.pl%2Foferta%2Fvolkswagen%2Ft-roc%2F1-5-2024r-3464-9420-ZN&repayment-term=84&okres=84&rata_kg=1956&rrso=8.46"
      }
    }
  },
  "leasing_source_info": {
    "value": "VEHIS",
    "logo_url": "https://autoplac-public-bucket.s3.eu-west-1.amazonaws.com/frontend-assets/logos/vehis_blank_840x84.png",
    "leasing_installment": 1095,
    "leasing_months": 60,
    "financing_links": {
      "yanosik": "https://vehis.pl/oferta/portale?portal=autoplac.pl&title=Vm9sa3N3YWdlbiBULVJvYw==&price=124900&url=aHR0cHM6Ly9hdXRvcGxhYy5wbC9vZmVydGEvdm9sa3N3YWdlbi90LXJvYy8xLTUtMjAyNHItMzQ2NC05NDIwLVpO&image=aHR0cHM6Ly9ldXcyLWNkbi5hdXRvcGxhYy5wbC92MS9wLzEzYTFkY2Y3LWI5ZTEtNGZmYy05YTAzLWJjYjA0ODYyYmY2MT9mPTE5MjA6d2VicCZjPWU1NWFkZjI4",
      "app": "https://vehis.pl/oferta/portale?portal=autoplac.pl&title=Vm9sa3N3YWdlbiBULVJvYw==&price=124900&url=aHR0cHM6Ly9hdXRvcGxhYy5wbC9vZmVydGEvdm9sa3N3YWdlbi90LXJvYy8xLTUtMjAyNHItMzQ2NC05NDIwLVpO&image=aHR0cHM6Ly9ldXcyLWNkbi5hdXRvcGxhYy5wbC92MS9wLzEzYTFkY2Y3LWI5ZTEtNGZmYy05YTAzLWJjYjA0ODYyYmY2MT9mPTE5MjA6d2VicCZjPWU1NWFkZjI4",
      "web": {
        "mobile": "https://vehis.pl/oferta/portale?portal=autoplac.pl&title=Vm9sa3N3YWdlbiBULVJvYw==&price=124900&url=aHR0cHM6Ly9hdXRvcGxhYy5wbC9vZmVydGEvdm9sa3N3YWdlbi90LXJvYy8xLTUtMjAyNHItMzQ2NC05NDIwLVpO&image=aHR0cHM6Ly9ldXcyLWNkbi5hdXRvcGxhYy5wbC92MS9wLzEzYTFkY2Y3LWI5ZTEtNGZmYy05YTAzLWJjYjA0ODYyYmY2MT9mPTE5MjA6d2VicCZjPWU1NWFkZjI4",
        "desktop": "https://vehis.pl/oferta/portale?portal=autoplac.pl&title=Vm9sa3N3YWdlbiBULVJvYw==&price=124900&url=aHR0cHM6Ly9hdXRvcGxhYy5wbC9vZmVydGEvdm9sa3N3YWdlbi90LXJvYy8xLTUtMjAyNHItMzQ2NC05NDIwLVpO&image=aHR0cHM6Ly9ldXcyLWNkbi5hdXRvcGxhYy5wbC92MS9wLzEzYTFkY2Y3LWI5ZTEtNGZmYy05YTAzLWJjYjA0ODYyYmY2MT9mPTE5MjA6d2VicCZjPWU1NWFkZjI4"
      }
    }
  },
  "price_info": {
    "primary": {
      "value": "124 900 zł",
      "value_without_currency": null,
      "brutto": true,
      "price": 124900,
      "promo_price_value": null
    },
    "secondary": {
      "value": "101 544 zł",
      "value_without_currency": null,
      "brutto": false,
      "price": 124900,
      "promo_price_value": null
    },
    "invoice_type": "FV23",
    "invoice_type_text": "FV 23%",
    "promo_value": null,
    "lowest_value30_days": null,
    "promo_valid_to": null,
    "promo_valid_from": null,
    "currency": "PLN"
  },
  "location_info": {
    "city": "Gdańsk",
    "voivodeship_id": 11,
    "voivodeship_name": "Pomorskie",
    "district_id": null,
    "district_name": "M. Gdańsk",
    "location_country": "POLAND",
    "location_country_name": "Polska",
    "street_name": null,
    "house_number": null,
    "coordinates": {
      "latitude": 54.399431,
      "longitude": 18.628473
    },
    "post_code": "80-530",
    "community_name": null,
    "voivodeship": "POMORSKIE",
    "voivodeship_display": "Pomorskie",
    "latitude": 54.399431,
    "longitude": 18.628473
  },
  "city": "Gdańsk",
  "voivodeship": "POMORSKIE",
  "voivodeship_display": "Pomorskie",
  "district_name": "M. Gdańsk",
  "location_country": "POLAND",
  "location_country_name": "Polska",
  "hashed_id": "1-5-2024r-3464-9420-ZN",
  "is_user_favorite": false,
  "lead_generation_enabled": false,
  "title": "Volkswagen T-Roc 1.5",
  "status": "PUBLISHED",
  "status_display_name": "Opublikowane",
  "insert_time": 1770826148505,
  "update_time": 1782739939606,
  "offer_promoted": true,
  "module_pro_type": "PRIORITIZED",
  "tags": [
    1,
    104,
    97,
    96,
    95,
    94,
    93,
    91,
    87,
    17,
    86,
    224,
    84,
    216,
    148,
    146,
    80,
    79,
    78,
    77,
    76,
    75,
    140,
    137,
    71,
    70,
    69,
    68,
    67,
    135,
    134,
    57,
    119,
    115,
    37
  ],
  "vehicle_type": "PASSENGER",
  "only_on_autoplac": false,
  "web_url": "/oferta/volkswagen/t-roc/1-5-2024r-3464-9420-ZN",
  "first_registration_date": "2025-07-03",
  "photo_list": [
    {
      "id": 2801245330,
      "offer_id": 3931265,
      "sort_number": 0,
      "url": "https://euw2-cdn.autoplac.pl/v1/p/13a1dcf7-b9e1-4ffc-9a03-bcb04862bf61?f=1920:webp&c=e55adf28",
      "miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/13a1dcf7-b9e1-4ffc-9a03-bcb04862bf61?m=true&f=500:webp&c=e55adf28",
      "webp_url": "https://euw2-cdn.autoplac.pl/v1/p/13a1dcf7-b9e1-4ffc-9a03-bcb04862bf61?f=1920:webp&c=e55adf28",
      "webp_miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/13a1dcf7-b9e1-4ffc-9a03-bcb04862bf61?m=true&f=500:webp&c=e55adf28"
    },
    {
      "id": 2801245331,
      "offer_id": 3931265,
      "sort_number": 1,
      "url": "https://euw2-cdn.autoplac.pl/v1/p/e2615fb3-6f02-4b05-8e79-3f54f1786389?f=1920:webp&c=e55adf28",
      "miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/e2615fb3-6f02-4b05-8e79-3f54f1786389?m=true&f=500:webp&c=e55adf28",
      "webp_url": "https://euw2-cdn.autoplac.pl/v1/p/e2615fb3-6f02-4b05-8e79-3f54f1786389?f=1920:webp&c=e55adf28",
      "webp_miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/e2615fb3-6f02-4b05-8e79-3f54f1786389?m=true&f=500:webp&c=e55adf28"
    },
    {
      "id": 2801245332,
      "offer_id": 3931265,
      "sort_number": 2,
      "url": "https://euw2-cdn.autoplac.pl/v1/p/6f8b23ef-997e-495f-a73e-80a7a8f6c22c?f=1920:webp&c=e55adf28",
      "miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/6f8b23ef-997e-495f-a73e-80a7a8f6c22c?m=true&f=500:webp&c=e55adf28",
      "webp_url": "https://euw2-cdn.autoplac.pl/v1/p/6f8b23ef-997e-495f-a73e-80a7a8f6c22c?f=1920:webp&c=e55adf28",
      "webp_miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/6f8b23ef-997e-495f-a73e-80a7a8f6c22c?m=true&f=500:webp&c=e55adf28"
    },
    {
      "id": 2801245333,
      "offer_id": 3931265,
      "sort_number": 3,
      "url": "https://euw2-cdn.autoplac.pl/v1/p/635d8f27-433a-41b2-ba05-a9bb3a0faa63?f=1920:webp&c=e55adf28",
      "miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/635d8f27-433a-41b2-ba05-a9bb3a0faa63?m=true&f=500:webp&c=e55adf28",
      "webp_url": "https://euw2-cdn.autoplac.pl/v1/p/635d8f27-433a-41b2-ba05-a9bb3a0faa63?f=1920:webp&c=e55adf28",
      "webp_miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/635d8f27-433a-41b2-ba05-a9bb3a0faa63?m=true&f=500:webp&c=e55adf28"
    },
    {
      "id": 2801245334,
      "offer_id": 3931265,
      "sort_number": 4,
      "url": "https://euw2-cdn.autoplac.pl/v1/p/42cf8a9c-9c14-4a0b-8b74-ea4defef9e8d?f=1920:webp&c=e55adf28",
      "miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/42cf8a9c-9c14-4a0b-8b74-ea4defef9e8d?m=true&f=500:webp&c=e55adf28",
      "webp_url": "https://euw2-cdn.autoplac.pl/v1/p/42cf8a9c-9c14-4a0b-8b74-ea4defef9e8d?f=1920:webp&c=e55adf28",
      "webp_miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/42cf8a9c-9c14-4a0b-8b74-ea4defef9e8d?m=true&f=500:webp&c=e55adf28"
    },
    {
      "id": 2801245335,
      "offer_id": 3931265,
      "sort_number": 5,
      "url": "https://euw2-cdn.autoplac.pl/v1/p/ad989f90-2080-485c-aca1-92198b79f015?f=1920:webp&c=e55adf28",
      "miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/ad989f90-2080-485c-aca1-92198b79f015?m=true&f=500:webp&c=e55adf28",
      "webp_url": "https://euw2-cdn.autoplac.pl/v1/p/ad989f90-2080-485c-aca1-92198b79f015?f=1920:webp&c=e55adf28",
      "webp_miniature_url": "https://euw2-cdn.autoplac.pl/v1/p/ad989f90-2080-485c-aca1-92198b79f015?m=true&f=500:webp&c=e55adf28"
    }
  ],
  "dealer": {
    "id": "dealer_2936",
    "description": "CityMotors Gdańsk Samochody Używane",
    "company_name": "BOHEMIA MOTORS SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ",
    "domain_alias": "citymotorsuzywane",
    "logo_url": "https://euw2-cdn.autoplac.pl/v1/p/dl/dealer_2936?f=300:jpeg&c=0000001f",
    "logo_webp_url": "https://euw2-cdn.autoplac.pl/v1/p/dl/dealer_2936?f=300:webp&c=7e072925",
    "type": "AUTHORIZED",
    "whats_app_available": true
  },
  "from_url": "https://autoplac.pl/oferty/samochody-osobowe"
}
```

Each vehicle record contains 44 fields capturing comprehensive automotive and marketplace metadata:

#### Vehicle Identification

| Field | Meaning |
|---|---|
| `ID` | Unique Autoplac identifier for the listing |
| `Brand` | Vehicle manufacturer (e.g., BMW, Skoda) |
| `Model` | Model name (e.g., 3 Series, Octavia) |
| `Generation` | Generation/body code (e.g., E92, 5E2) |
| `Version` | Trim or variant level |
| `Brand ID` | Internal brand identifier |
| `Model ID` | Internal model identifier |
| `VIN Available` | Boolean flag indicating VIN presence |

#### Technical Specifications

| Field | Meaning |
|---|---|
| `Production Year` | Year the vehicle was manufactured |
| `Mileage` | Current odometer reading in kilometers |
| `Engine Power (kW)` | Engine output in kilowatts |
| `Engine Capacity` | Engine displacement in cubic centimeters |
| `Fuel Type` | Energy source (petrol, diesel, hybrid, electric, etc.) |
| `Fuel Type Text` | Human-readable fuel type label |
| `Transmission Type` | Gearbox type (manual, automatic, CVT, etc.) |
| `Drive Type` | Drivetrain (FWD, RWD, AWD) |
| `Seats` | Number of passenger seats |
| `Body Type` | Vehicle category code |
| `Body Type Text` | Readable body type (sedan, SUV, hatchback, etc.) |
| `First Registration Date` | Initial registration date in Poland or abroad |

#### Pricing & Financing

| Field | Meaning |
|---|---|
| `Price Info` | Sale price in Polish zloty (PLN) or currency specified |
| `Loan Source Info` | Whether financing/loan options are available |
| `Leasing Source Info` | Whether leasing options are available |

#### Location & Market Presence

| Field | Meaning |
|---|---|
| `Location Info` | Full location data object |
| `City` | City or town name |
| `Voivodeship` | Polish administrative region (e.g., Mazovian) |
| `Voivodeship Display` | Formatted region name for display |
| `District Name` | District (powiat) level information |
| `Location Country` | Country code (PL, DE, etc.) |
| `Location Country Name` | Full country name |

#### Listing Metadata

| Field | Meaning |
|---|---|
| `User ID` | Seller's Autoplac account ID |
| `Title` | Listing headline/title text |
| `Status` | Current listing state (active, sold, removed, etc.) |
| `Status Display Name` | Formatted status label |
| `Insert Time` | Timestamp when listing was created |
| `Update Time` | Last update timestamp |
| `Hashed ID` | Anonymized identifier for privacy |
| `Is User Favorite` | Boolean: marked as favorite by viewers |

#### Promotion & Visibility

| Field | Meaning |
|---|---|
| `Offer Promoted` | Whether the listing has paid promotion |
| `Module Pro Type` | Promotion package type (if applicable) |
| `Lead Generation Enabled` | Whether seller accepts direct inquiries |
| `Only On Autoplac` | Exclusive listing flag |
| `Tags` | Seller-applied tags or categories |

#### Additional Data

| Field | Meaning |
|---|---|
| `Vehicle Type` | Detailed classification (personal, commercial, etc.) |
| `Dealer` | Seller profile: whether a dealer or private seller |
| `Web URL` | Direct link to the individual listing page |
| `Photo List` | Array of image URLs for the vehicle |

***

### How to Use

1. **Find category URLs** — Navigate to Autoplac.pl, select "Samochody osobowe" (personal cars), and apply filters if needed. Copy the page URL (including pagination parameters like `?p=2`).

2. **Prepare input JSON** — Add URLs to the `urls` array. Set `max_items_per_url` based on your needs (typical: 20–200 vehicles per page).

3. **Configure settings** — Keep `ignore_url_failures: true` for large bulk runs to prevent interruptions.

4. **Execute the scraper** — Start the actor and monitor progress in the run log.

5. **Export data** — Download results as JSON, CSV, or Excel; import into your CRM, spreadsheet, or database.

**Best practices:**

- Test with a single URL before running large batches.
- Use specific category URLs to avoid irrelevant results (e.g., filter by region or price range directly on Autoplac).
- Combine multiple paginated URLs to build comprehensive datasets.

**Common issues:**

- If no data is returned, verify the URL is a valid Autoplac listing page, not a search redirect.
- Increase `max_items_per_url` if Autoplac displays more vehicles per page than expected.

***

### Use Cases & Business Value

- **Competitive pricing:** Monitor dealer pricing strategies across regions
- **Inventory tracking:** Track competitor stock turnover and listing frequency
- **Market research:** Analyze supply trends by brand, model, age, and fuel type
- **Lead generation:** Identify high-turnover dealers or regions for sales outreach
- **Data aggregation:** Feed Autoplac listings into your own multi-source vehicle portal

The Autoplac Automotive Scraper transforms raw marketplace data into business intelligence, saving hours of manual work and enabling data-driven decisions in automotive sales, pricing, and marketing.

***

### Conclusion

The **Autoplac.pl Automotive Scraper** is the fastest way to extract structured vehicle data from Poland's premier auto marketplace. With 44 detailed fields covering specs, pricing, location, and seller information, it supports competitive analysis, market research, and platform aggregation at scale. Begin scraping today and unlock actionable automotive market insights.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the auctions urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://autoplac.pl/oferty/samochody-osobowe?p=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "PL"
  }
}
```

# 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 = {
    "urls": [
        "https://autoplac.pl/oferty/samochody-osobowe?p=2"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "PL"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/autoplac-automotive-search-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 = {
    "urls": ["https://autoplac.pl/oferty/samochody-osobowe?p=2"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "PL",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/autoplac-automotive-search-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 '{
  "urls": [
    "https://autoplac.pl/oferty/samochody-osobowe?p=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "PL"
  }
}' |
apify call stealth_mode/autoplac-automotive-search-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Autoplac Automotive Search Scraper",
        "description": "Scrape detailed vehicle listings from Autoplac.pl, Poland's largest auto marketplace. Extract 44+ fields including brand, model, price, mileage, engine specs, location, and seller details — perfect for market research, price monitoring, and inventory analysis.",
        "version": "0.0",
        "x-build-id": "CwlJhc5l4bNGNCuPu"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~autoplac-automotive-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-autoplac-automotive-search-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/stealth_mode~autoplac-automotive-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-autoplac-automotive-search-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/stealth_mode~autoplac-automotive-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-autoplac-automotive-search-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",
                "properties": {
                    "urls": {
                        "title": "URLs of the auctions urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the auctions urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "ignore_url_failures": {
                        "title": "Continue running even if some URLs fail to be scraped",
                        "type": "boolean",
                        "description": "If true, the scraper will continue running even if some URLs fail to be scraped."
                    },
                    "max_items_per_url": {
                        "title": "Max items per URL",
                        "type": "integer",
                        "description": "The maximum number of items to scrape per URL."
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Select proxies to be used by your scraper."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
