# Autosupermarket Automotive Search Scraper (`stealth_mode/autosupermarket-automotive-search-scraper`) Actor

Scrape comprehensive used car data from Autosupermarket.it with our automotive listing scraper. Collect prices, specs, dealer info, photos, and 26+ fields per vehicle — perfect for market analysis, inventory tracking, and competitive research.

- **URL**: https://apify.com/stealth\_mode/autosupermarket-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 $2.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.
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.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

## Autosupermarket.it Automotive Scraper: Extract Used Car Listings Instantly
---

### What Is Autosupermarket.it?

Autosupermarket.it is Italy's largest online marketplace for used vehicles, hosting thousands of car listings from private sellers and professional dealers. The platform aggregates inventory across regions, making it a valuable source for automotive market intelligence, pricing analysis, and inventory benchmarking. However, manually extracting and organizing this vehicle data is inefficient — the **Autosupermarket Automotive Scraper** automates the entire process, delivering structured, analysis-ready datasets.

---

### Overview

The **Autosupermarket Automotive Search Scraper** extracts detailed vehicle listings from Autosupermarket.it search results and catalog pages, converting unstructured HTML into clean, structured records. It is ideal for:

- **Used car dealers** monitoring competitor inventory and pricing strategies
- **Market researchers** analyzing automotive price trends and availability by region
- **Data analysts** building automotive datasets for predictive pricing models
- **Automotive platforms** aggregating and syndicating inventory listings
- **Fleet managers** sourcing vehicles in bulk and tracking market conditions

The scraper handles large-scale collection efficiently with configurable item limits, automatic failure recovery, and support for paginated search results.

---

### Input Format

The scraper accepts a JSON configuration object to control what and how much to scrape:

```json
{
  "urls": [
    "https://autosupermarket.it/auto-usate/mondo-tuning?page=2&t=5cdbm"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 200
}
````

#### Configuration Parameters

| Parameter | Type | Description |
|---|---|---|
| `urls` | Array of strings | Direct links to Autosupermarket.it search results or catalog pages. Each URL is processed independently to extract listings. Supports paginated results (e.g., `?page=1`, `?page=2`). You can paste URLs one by one or bulk-import a prepared list. |
| `ignore_url_failures` | Boolean | If `true`, the scraper continues running even if some URLs fail to load or return errors. Default: `true`. If `false`, any URL failure will halt the entire run. Recommended: keep as `true` for robust bulk scraping. |
| `max_items_per_url` | Integer | Maximum number of vehicle listings to extract from each URL. Default: `20`. Range: `1–200+`. Higher values collect more inventory but extend runtime. Set based on your data volume needs. |

> **Tip:** For multi-page scraping, add several pagination URLs (page 1, 2, 3, etc.) separately in the `urls` array to maximize coverage without hitting rate limits.

***

### Output Format

**Sample output**

```json
{
  "id": 3116694,
  "address": {
    "coordinates": {
      "latitude": 45.110573,
      "longitude": 7.671711
    },
    "city": "Torino",
    "zip_code": "10148",
    "province": "TO",
    "address": "Via Guglielmo Reiss Romoli 265/6",
    "complete": "Via Guglielmo Reiss Romoli 265/6 - 10148 Torino (TO)"
  },
  "brand": {
    "id": 40,
    "name": "BMW"
  },
  "dealer": {
    "id": 11011,
    "name": "COMPETITION CARS",
    "logo": "https://autosupermarket.it/media/images/search/default-headquarter.png"
  },
  "heading": "BMW Serie 3 M3",
  "headquarter": {
    "id": 11370,
    "name": "COMPETITION CARS",
    "logo": "https://cdn.autosupermarket.it/uploads/prod/7dc035bd14fd3ec21a10ff20ca0effa1.jpg",
    "cover_image_url": "",
    "shown_name": "COMPETITION CARS",
    "dealer": {
      "name": "COMPETITION CARS"
    },
    "whatsapp": "+39 334 744 2054",
    "call_tracking_enabled": true,
    "active_subscription": {
      "type": "pro"
    },
    "_links": {
      "sheet": {
        "href": "/concessionari/piemonte/torino/competition-cars"
      }
    },
    "_rating": {
      "average": 4.32,
      "reviews": 25
    }
  },
  "owner": null,
  "model": {
    "id": 6731,
    "name": "M3",
    "parent": {
      "id": 869,
      "name": "Serie 3"
    }
  },
  "previous_price": 74900,
  "price": 72900,
  "real_price": 72900,
  "has_promotion": false,
  "promotion_description": null,
  "visible": true,
  "pro": true,
  "type": 2,
  "pro_plus_pinned": true,
  "preview": "https://cdn.autosupermarket.it/photos/prod/3116694/04855179b07bd9b3c5d8875fbe30ad06.jpg",
  "shown_photos": [
    {
      "id": 105716869,
      "blurhash": "L$JkcZxuxaoL~qt7WVofxtRkWBt7",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/04855179b07bd9b3c5d8875fbe30ad06.jpg",
      "tag": "exterior_body_front_side_left"
    },
    {
      "id": 105716870,
      "blurhash": "LXGum]^+%0%1_N%MNGkC?Gxut7bI",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/369f6f6c395d6e6c7603451cdf79dd30.jpg",
      "tag": "exterior_lights"
    },
    {
      "id": 105716871,
      "blurhash": "L%LD}exu%2xa~qoeWXoz%1R*WBt7",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/83cb36576d2283b3088c9ebb3e14ff7b.jpg",
      "tag": "exterior_body_front_side_left"
    },
    {
      "id": 105716872,
      "blurhash": "LXH1}Q%0tR$f~pxuj]oz.8xaVsSg",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/b2821df30387fc2edb167a3788b91119.jpg",
      "tag": "exterior_body_rear_side_left"
    },
    {
      "id": 105716873,
      "blurhash": "LVGIly$x-;nM_NxuM|WBxut7M{R+",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/166c60a528f95c322dc37623dcfae2d3.jpg",
      "tag": "exterior_body_rear"
    },
    {
      "id": 105716874,
      "blurhash": "LPEyPVWEM{oL~pj]M{Rj_2M|Myt6",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/a08e5a13931af0d9d7ea9f6286d2f5d9.jpg",
      "tag": "interior_dash"
    },
    {
      "id": 105716875,
      "blurhash": "LEFiA99F^,M|~p_2%MRls9.7xaRk",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/7ab6f5801aba61e5eb7b27ecaac77a1d.jpg",
      "tag": "interior_seats"
    },
    {
      "id": 105716876,
      "blurhash": "LEFYrr009GE1%eIVM}a~~pDjxus:",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/df280bb92769562965b3a5de40cc593f.jpg",
      "tag": "interior_seats"
    },
    {
      "id": 105716877,
      "blurhash": "LJHB@@00~qIBSb.7xaoh-.xt9GE1",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/a5a7cbb2968b72ea45dc4f30cffb0a4f.jpg",
      "tag": "interior_seats"
    },
    {
      "id": 105716879,
      "blurhash": "L4C6okD*NL-o00~p-p%300xa?bRP",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/57d31a6dd8ebf266355acb0508e25b46.jpg",
      "tag": "interior_dash"
    },
    {
      "id": 105716880,
      "blurhash": "LOFh-M?F?G%1?bM}R.R.~Vs9-ot7",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/755a85638431040f4fca3456c79b866e.jpg",
      "tag": "interior_wheel"
    },
    {
      "id": 105716881,
      "blurhash": "LiFP4]s:Rjof~qf5jFt7~Wt6WBs:",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/749e32b1c631ce2d828b2ff20e042469.jpg",
      "tag": "interior_dash"
    },
    {
      "id": 105716882,
      "blurhash": "L@G[ZZs8s:xa~VjEjtof^%n#oLj]",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/475fee3e134e7b9432a090b4899c4aa5.jpg",
      "tag": "interior_dash"
    },
    {
      "id": 105716884,
      "blurhash": "LqGR^;s:M_s:~poJnht7_2oJjYt6",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/76e70aaab09dc7bb5158a720e3deec08.jpg",
      "tag": "interior_dash"
    },
    {
      "id": 105716885,
      "blurhash": "LlEfQha%V?jq~poMWAj?_1WAjbog",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/afa8c67d06fd5fa2c47bd54886266104.jpg",
      "tag": "interior_dash"
    },
    {
      "id": 105716887,
      "blurhash": "L5C6uzDjD*jFaK~WRjxtnPIU.7of",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/c302238ce9bf613b22230409b4ed9456.jpg",
      "tag": "interior_doors"
    },
    {
      "id": 105716888,
      "blurhash": "LRDJ08?H%L-p~p-p%L%L%L%Lxaxt",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/10bf182820ee9f2365fd2cc9db6b1fa8.jpg",
      "tag": "interior_dash"
    },
    {
      "id": 105716890,
      "blurhash": "LiHeqIkWxut6~qM|of%2-;bHRjax",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/1ffae1e1030cb0834c9f822348a45fce.jpg",
      "tag": "exterior_tires"
    },
    {
      "id": 105716891,
      "blurhash": "LQHLF]Vr?at6u5xBtSkC~VjYs:of",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/ee3f13b3a3829d27df1472a7a0076ba8.jpg",
      "tag": "exterior_tires"
    },
    {
      "id": 105716893,
      "blurhash": "LPHeRX?F~p?GTzM|tmSO~Ws:-;X8",
      "public_url": "https://cdn.autosupermarket.it/photos/prod/3116694/67c3f473a1a84ceede842a754acfd411.jpg",
      "tag": "exterior_tires"
    }
  ],
  "title": "M3 COMPETITION",
  "description": "BMW M3 Competition \n\n\nANNO: 2022\nKM: 40.000\n\n\nUnico proprietario \nIVA esposta totale \nFull optional \n\n\nSI RICEVE SOLO SU APPUNTAMENTO \n\n\n“PREZZO REALE NON VINCOLATO A FINANZIAMENTO”\n\n\nVALUTO PERMUTE \nGaranzia 12 mesi \n\n\nAuto visibile in Via Reiss Romoli 265/6 Torino\n",
  "publish_date": "2026-03-25T12:08:23+01:00",
  "vehicle": {
    "warranty": null,
    "detail": {
      "body": "sedan",
      "doors": 4,
      "external_color": "gray",
      "internal_color": "black",
      "featured_accessories": [
        "Sistema di navigazione",
        "Cerchi in lega",
        "Sedili sportivi",
        "Vetri oscurati (edited)"
      ]
    },
    "engine": {
      "drivetrain": "rear",
      "gearbox": "automatic",
      "power": 375,
      "gears": 8,
      "hp": 510,
      "suitable_for_youngdrivers": false
    },
    "environment": {
      "fuel": "petrol"
    },
    "status": {
      "damaged": false,
      "category": "used",
      "km": 41000,
      "registration_date": "2022-12-13T00:00:00+01:00"
    }
  },
  "links": null,
  "has_video": null,
  "from_url": "https://autosupermarket.it/auto-usate/mondo-tuning"
}
```

Each scraped vehicle record contains 26+ fields capturing pricing, specifications, dealer information, and media assets:

#### Vehicle Identification

| Field | Meaning |
|---|---|
| `ID` | Unique listing identifier in the Autosupermarket system |
| `Title` | Vehicle headline as shown to buyers (e.g., "BMW 320d 2018 - Low Mileage") |
| `Heading` | Primary display title of the listing |
| `Brand` | Car manufacturer (e.g., BMW, Fiat, Volkswagen) |
| `Model` | Specific model name (e.g., 320d, 500, Golf) |
| `Type` | Vehicle category (e.g., sedan, SUV, station wagon, hatchback) |
| `Vehicle` | Complete vehicle metadata and specifications |

#### Pricing Information

| Field | Meaning |
|---|---|
| `Price` | Current listed price in EUR |
| `Previous Price` | Original asking price before reduction (if applicable) |
| `Real Price` | Actual negotiated or final price (when available) |
| `Has Promotion` | Boolean flag indicating active promotional pricing |
| `Promotion Description` | Text describing the discount or offer (e.g., "50€ discount for quick sale") |

#### Seller & Location

| Field | Meaning |
|---|---|
| `Dealer` | Dealer name or private seller identifier |
| `Owner` | Listing owner details (individual or dealership account) |
| `Address` | Physical location or showroom address |
| `Headquarter` | Dealer's headquarters or main office location |

#### Listing Status & Features

| Field | Meaning |
|---|---|
| `Visible` | Whether the listing is publicly visible (boolean) |
| `Pro` | Whether the seller has a "Pro" verified dealer badge |
| `Pro Plus Pinned` | Whether the listing is pinned/promoted via Pro Plus membership |
| `Publish Date` | Date the listing was first published |
| `Has Video` | Whether the listing includes a video walkthrough (boolean) |

#### Media & Preview

| Field | Meaning |
|---|---|
| `Preview` | Thumbnail or preview image URL |
| `Shown Photos` | Array of photo URLs for the vehicle (interior, exterior, details) |
| `Links` | External links associated with the listing (e.g., vehicle history report, additional details) |

#### Description

| Field | Meaning |
|---|---|
| `Description` | Full vehicle description including condition, history, features, and seller notes |

***

### How to Use

1. **Identify target URLs** — Browse Autosupermarket.it and find search result pages or category listings (e.g., used cars, tuning vehicles, by region). Copy the full URLs including filters and pagination parameters.

2. **Configure input** — Paste URLs into the `urls` array. For large datasets, add multiple pages. Set `max_items_per_url` to control volume per page (e.g., `200` for full page extraction, `50` for samples).

3. **Enable failure handling** — Leave `ignore_url_failures: true` to prevent interruptions if a page temporarily unavailable.

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

5. **Download results** — Export output as JSON, CSV, or Excel for analysis, database import, or platform integration.

**Best practices:**

- Scrape during off-peak hours to minimize server load.
- Stagger requests if collecting very large datasets to avoid rate limiting.
- Verify price data accuracy by spot-checking against live listings.
- Update runs regularly to track price changes and new inventory.

***

### Use Cases & Business Value

- **Competitive pricing intelligence:** Monitor dealer pricing strategies in real time
- **Market trend analysis:** Track supply, demand, and price evolution by brand, model, and region
- **Inventory aggregation:** Build custom automotive marketplaces by syndicating Autosupermarket listings
- **Lead generation:** Identify high-value inventory and sellers for targeted outreach
- **Price prediction models:** Train ML models using historical price and specification data

By automating data collection, the scraper reduces manual effort from hours to minutes, enabling data-driven decision-making across sales, marketing, and strategy teams.

***

### Conclusion

The **Autosupermarket.it Automotive Scraper** streamlines used vehicle data extraction, delivering rich, structured records from Italy's premier automotive marketplace. Whether you're benchmarking prices, aggregating inventory, or analyzing market trends, this tool transforms raw listings into actionable intelligence at scale.

# Actor input Schema

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

Add the URLs of the Automotive list 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.

## Actor input object example

```json
{
  "urls": [
    "https://autosupermarket.it/auto-usate/mondo-tuning?page=2&t=5cdbm"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}
```

# 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://autosupermarket.it/auto-usate/mondo-tuning?page=2&t=5cdbm"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("stealth_mode/autosupermarket-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://autosupermarket.it/auto-usate/mondo-tuning?page=2&t=5cdbm"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("stealth_mode/autosupermarket-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://autosupermarket.it/auto-usate/mondo-tuning?page=2&t=5cdbm"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20
}' |
apify call stealth_mode/autosupermarket-automotive-search-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Autosupermarket Automotive Search Scraper",
        "description": "Scrape comprehensive used car data from Autosupermarket.it with our automotive listing scraper. Collect prices, specs, dealer info, photos, and 26+ fields per vehicle — perfect for market analysis, inventory tracking, and competitive research.",
        "version": "0.0",
        "x-build-id": "B40rOcxglQZNo09UL"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/stealth_mode~autosupermarket-automotive-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-stealth_mode-autosupermarket-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~autosupermarket-automotive-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-stealth_mode-autosupermarket-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~autosupermarket-automotive-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-stealth_mode-autosupermarket-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 Automotive list urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the Automotive list 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."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
