# SEAT Spain Stock Scraper - New Car Dealer Inventory (`rastriq/seat-spain-stock-scraper`) Actor

Extract SEAT new-car dealer stock in Spain: sale vs list price, specs, color, DGT label and dealer contact from seat.es. Mainland and Canary Islands.

- **URL**: https://apify.com/rastriq/seat-spain-stock-scraper.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** Automation, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SEAT Spain Stock Scraper — Live Dealer Inventory

Extract every SEAT vehicle currently available at Spanish dealerships — sale price, list price, engine specs, color, dealer location, DGT emission label, and more — directly from the official `seat.es` stock locator API. **SEAT Spain Stock Scraper** covers the complete national inventory: mainland Spain and Canary Islands (~1,855 units) in a single run, with no browser automation and no login required.

> 🚀 **Try it cheaply** — click **Start** with the prefilled `max_results: 10`.

### 📌 What is SEAT Spain Stock Scraper?

**SEAT Spain Stock Scraper** is an unofficial SEAT Spain inventory API built on top of the internal `vtpapi.seat.com` endpoint that powers [www.seat.es/localizador-stock](https://www.seat.es/localizador-stock). It gives you programmatic, bulk access to the full dealer stock — something the official website doesn't offer.

Unlike the SEAT website, which shows 12 vehicles per page with no export button, **SEAT Spain Stock Scraper** retrieves the entire catalogue in one shot: all models, all trims, all dealers, all prices — structured and ready for analysis.

Use **SEAT Spain Stock Scraper** to:

- 💶 **Monitor real sale prices vs. list prices** — track the actual discount depth being applied across the Spanish market in near real-time
- 📊 **Analyze inventory distribution** — understand stock levels by model, region, fuel type, and dealer
- 🏆 **Build competitive pricing dashboards** — pair with [SEAT Prices Scraper](https://apify.com/Rastriq/seat-prices-scraper) to compare configurator RRP against actual dealer stock prices
- 🌱 **Track electrification progress** — filter by `Electric` or `Hybrid` to monitor BEV and PHEV availability across the network
- 🔄 **Automate recurring market reports** — schedule daily or weekly runs and pipe data into your BI tool, Google Sheets, or database

#### Why use it instead of generic car-listing scrapers?

- **Official new-car stock, not classifieds**: coches.net, AutoScout24 and Wallapop scrapers cover used and mixed listings; this one reads SEAT's own dealer stock locator.
- **Sale price and list price in the same record**, so you can compute real discount depth per unit.
- **Plain HTTP, no browser or proxy**: fast (about a minute for the full stock) and cheap.
- **Dealer name, city, province and phone** attached to every unit.

### 📋 What data does SEAT Spain Stock Scraper extract?

One structured record per vehicle unit in stock:

|  |  |
|--|--|
| 🚗 Model, full title & trim level | ⛽ Fuel type & transmission |
| ⚡ Engine power (kW and HP/CV) | 🔩 Engine displacement (cc) |
| 🎨 Marketing color + generic color family | 🚪 Number of doors |
| 💶 Sale price (€) | 💴 List price / PVP (€) |
| 🏷️ DGT emission label (0, ECO, C, B) | 📋 Condition (new vehicle) |
| 🏢 Dealer name & ID | 📍 Dealer city & province |
| ☎️ Dealer phone number | 🌐 Dealer website |
| 📅 Date listed & production date | 🖼️ Render image URL |
| 🔑 Vehicle ID (VIN format) | 🕐 Extraction timestamp |

**Full field reference:**

| Field | Type | Description |
|-------|------|-------------|
| `vin` | string | Vehicle identifier (`ESP0XXXX-YYYY-ZZZ` format) |
| `model` | string | SEAT model name (Ibiza, Arona, León, Ateca…) |
| `title` | string | Full commercial title (e.g. "Seat Ibiza Nuevo 1.0 MPI 59 KW (80 CV) Start/Stop +") |
| `version` | string | Trim level (Reference, Style, FR, Xcellence…) |
| `body_type` | string | Body style as shown on the stock locator |
| `fuel_type` | string | Fuel / propulsion type in Spanish |
| `transmission` | string | Gearbox type (Cambio manual / automático) |
| `drive_type` | string | Drive configuration (Tracción delantera…) |
| `power_kw` | integer | Engine output in kilowatts |
| `power_hp` | integer | Engine output in CV (horsepower) |
| `engine_cc` | integer | Engine displacement in cm³ |
| `doors` | integer | Number of doors |
| `color_exterior` | string | Marketing color name (e.g. "Azul Fiord") |
| `color_generic` | string | Generic color family (e.g. "Azul") |
| `price_sale` | number | Current sale price in EUR |
| `price_list` | number | Original list price / PVP in EUR |
| `currency` | string | Always `EUR` |
| `availability` | string | Availability status (e.g. "Immediately") |
| `date_offer` | string | Date the vehicle was listed (ISO 8601) |
| `date_production` | string | Manufacturing date (ISO 8601) |
| `emission_label` | string | Spanish DGT label code (DGTC, DGTB, ZERO…) |
| `condition` | string | Vehicle condition (always "Vehículo nuevo") |
| `dealer_id` | string | Internal dealer identifier |
| `dealer_name` | string | Dealership name |
| `dealer_city` | string | Dealership city |
| `dealer_region` | string | Province of the dealership |
| `dealer_phone` | string | Dealership phone number |
| `dealer_website` | string | Dealership website URL |
| `image_url` | string | URL of the official render image |
| `scraped_at` | string | ISO 8601 extraction timestamp |

### 🚀 How to use SEAT Spain Stock Scraper

Extracting the full SEAT Spain dealer inventory takes roughly one to two minutes:

1. **Create a free Apify account** at [apify.com](https://apify.com) (the free plan includes monthly platform credit)
2. **Open SEAT Spain Stock Scraper** and click **Try for free**
3. **Start with the prefilled `max_results: 10`** to see the output format, then set it to `0` for the complete national stock, or apply filters (model, fuel type, price range)
4. **Choose Region** (all Spain, mainland or Canary Islands) if needed
5. **Click Save & Start** — the actor paginates automatically through the full inventory
6. **Download results** as JSON, CSV, or Excel from the Output tab, or connect via the Apify API

#### Setting up recurring price monitoring

1. Save your run configuration as an Apify **Task**
2. Go to **Schedules** in Apify Console and set the frequency (e.g. daily at 7am)
3. Add a **webhook** to push results to your pipeline when each run finishes
4. Compare `price_sale` vs `price_list` across consecutive datasets to detect discount changes, new arrivals, or sold-out units

### ⚙️ Input parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `region` | string | *(all)* | `""` all Spain, `Spain` mainland only, `CanaryIslands` Canary Islands only |
| `model` | string | *(all)* | SEAT model (dropdown: Ibiza, Arona, León, León Sportstourer, Ateca) |
| `fuel_type` | string | *(all)* | `B` gasoline, `D` diesel, `H` hybrid (MHEV/HEV/PHEV) |
| `body_type` | string | *(all)* | Dropdown: urban, compact, SUV/crossover, estate |
| `transmission` | string | *(all)* | `H` manual, `A` automatic |
| `max_results` | integer | `0` (no limit) | Result cap. Use `10` for a quick test |
| `price_min` / `price_max` | integer | - | Sale price range in EUR |
| `power_kw_min` / `power_kw_max` | integer | - | Engine power range in kW |
| `sort_by` | string | `PRICE_SALE` | `PRICE_SALE`, `POWER_KW` or `MODEL` |
| `sort_direction` | string | `ASC` | `ASC` or `DESC` |
| `page_size` | integer | `50` | Vehicles per API request (1-100) |
| `image_width` | integer | `800` | Render image width in px (400-2048) |

> Only models currently in stock return results. The stock locator covers the SEAT brand only (CUPRA is not included).

**Example — full national inventory, sorted by price:**

```json
{
  "sort_by": "PRICE_SALE",
  "sort_direction": "ASC"
}
```

**Example — electric and hybrid SEATs in mainland Spain:**

```json
{
  "region": "Spain",
  "fuel_type": "electric",
  "sort_by": "PRICE_SALE"
}
```

**Example — quick smoke test, 10 units:**

```json
{
  "max_results": 10,
  "page_size": 12
}
```

### 📦 Output example

Real record from a live run:

```json
{
  "vin": "ESP03938034046-2026-781",
  "model": "Ibiza",
  "title": "Seat Ibiza Nuevo 1.0 MPI 59 KW (80 CV) Start/Stop +",
  "version": "Reference",
  "body_type": "Urbano",
  "fuel_type": "Gasolina",
  "transmission": "Cambio manual",
  "drive_type": "Tracción delantera",
  "power_kw": 59,
  "power_hp": 80,
  "engine_cc": 999,
  "doors": 4,
  "color_exterior": "Azul Fiord",
  "color_generic": "Azul",
  "price_sale": 15750.0,
  "price_list": 18869.98,
  "currency": "EUR",
  "availability": "Immediately",
  "date_offer": "2026-07-01T12:31:24Z",
  "date_production": "2026-05-06T00:00:00Z",
  "emission_label": "DGTC",
  "condition": "Vehículo nuevo",
  "dealer_id": "ESP03938",
  "dealer_name": "AUTOS BELLAMAR",
  "dealer_city": "FUENGIROLA",
  "dealer_region": "MALAGA",
  "dealer_phone": "952473111",
  "dealer_website": "www.concesionarios.seat/autos-bellamar",
  "image_url": "https://render.seat.es/SEA/RENDER/PRD/render/fast/v3_...",
  "scraped_at": "2026-07-08T19:24:48.999680+00:00"
}
```

Download results as **JSON, CSV, Excel, or XML** from the Output tab, or access them programmatically via the Apify API (see the API tab for ready-to-use snippets in Python, Node.js, and cURL).

### 💰 How much does it cost to use SEAT Spain Stock Scraper?

Pay-per-event pricing: you pay per vehicle record returned, with volume discounts by Apify plan (FREE / BRONZE / SILVER / GOLD). See the **Pricing** tab for current rates. Typical cost on the FREE tier:

| Run scope | Vehicles | Approx. cost |
|-----------|----------|--------------|
| Quick test (`max_results: 10`) | 10 | about $0.04 |
| One model (e.g. Ibiza) | a few hundred | about $1-2 |
| Full national stock | about 1,900 | about $7-8 |

Platform compute for a full run is a few cents (plain HTTP, no browser, no proxy). You can set a maximum spend per run in Apify; the actor stops cleanly when the limit is reached.

### 🔗 Related Rastriq Actors

Explore the full [Rastriq automotive intelligence portfolio](https://apify.com/Rastriq) on Apify Store:

| Actor | Description |
|-------|-------------|
| [SEAT Prices Scraper](https://apify.com/Rastriq/seat-prices-scraper) | Official configurator RRP for all SEAT models and trim levels in Spain |
| [BYD Global Catalog Scraper](https://apify.com/Rastriq/byd-global-catalog-scraper) | BYD model and pricing data from configurators across multiple markets |
| [MG Motor EU Scraper](https://apify.com/Rastriq/mg-motor-eu-scraper) | MG Motor configurator prices for the European market |

> 💡 **Power combo**: Run **SEAT Spain Stock Scraper** (real dealer prices) alongside **SEAT Prices Scraper** (configurator RRP) to calculate the actual discount depth being applied across the Spanish market — a key signal for competitive intelligence and fleet buying decisions.

### ❓ Frequently Asked Questions

#### Is scraping SEAT Spain dealer inventory legal?

**SEAT Spain Stock Scraper** only accesses **publicly available data** — the same inventory information any visitor sees on [www.seat.es/localizador-stock](https://www.seat.es/localizador-stock) without logging in. No personal data, no user accounts, no private information is extracted. The actor applies conservative rate limiting (≈1 request per second) to avoid overloading the servers.

As with any data collection activity, you are responsible for ensuring your use case complies with applicable regulations (GDPR, LSSI) and SEAT's Terms of Service. For general guidance, see [Apify's blog on the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

#### Does SEAT Spain Stock Scraper require a login or API key?

No. The actor accesses the public stock locator endpoint — no SEAT account, no login, no API credentials required.

#### What do Canary Islands records look like?

Canary Islands stock uses the IGIC tax regime instead of IVA, so prices are not directly comparable with mainland. Prices are returned as exposed by the API; if `price_sale` or `price_list` is `null` for a unit, the API did not provide it. Records are never dropped, so filter nulls in your own pipeline.

#### How many vehicles are in the SEAT Spain inventory?

The total fluctuates daily as vehicles are sold and new units arrive. At the time of the last verification (July 2026) the locator showed approximately 1,855 units (about 1,675 mainland and 180 Canary Islands). Run without filters to get the current count.

#### How fresh is the data?

The actor queries the live `vtpapi.seat.com` endpoint in real time. Data reflects the exact state of the SEAT Spain stock locator at the moment of the run. For continuous freshness, schedule daily runs via Apify's built-in scheduler.

#### Can I filter by province or specific dealer?

Province-level filtering is not directly supported in the input — the API exposes only `Spain` (mainland) and `CanaryIslands` as region values. To analyze by province, extract the full stock and filter the dataset by `dealer_region` (which contains the province name, e.g. `MALAGA`, `BARCELONA`).

#### What if a run returns 0 results?

1. Check the run log for HTTP errors (403, 429)
2. Try again after a few minutes — the SEAT API occasionally returns empty responses under load
3. Reduce `page_size` to 12 and add a small delay between runs
4. Open an issue in the **Issues tab** with your run ID

#### How do I integrate SEAT Spain Stock Scraper with my workflow?

- **Make / Zapier** — trigger runs on a schedule, receive data in Slack, email, or any webhook endpoint
- **Google Sheets** — use the Apify → Google Sheets integration to export directly
- **Python** — use `apify-client` to run the actor and load results into a pandas DataFrame
- **Supabase / PostgreSQL** — connect the Apify dataset API to your ETL pipeline
- **Power BI / Tableau** — connect to the Apify dataset REST endpoint as a JSON data source

#### I found a bug or the output looks wrong. Where do I report it?

Open an issue in the **Issues tab** on this page. Include your input configuration and the run ID. SEAT occasionally updates their internal API — we aim to push fixes within 48 hours of confirmed breakage.

# Actor input Schema

## `region` (type: `string`):

Market to scrape. <b>All Spain</b> = mainland + Canary Islands. Canary Islands use IGIC instead of IVA, so prices are not directly comparable with mainland.

## `model` (type: `string`):

Filter by SEAT model. Leave empty for all models. Only models with units in stock return results.

## `fuel_type` (type: `string`):

Filter by propulsion type.<br><br>• <b>All</b> — no filter<br>• <b>Gasoline / Diesel</b> — internal combustion<br>• <b>Hybrid</b> — covers MHEV, HEV, and PHEV variants

## `body_type` (type: `string`):

Filter by vehicle body style.

## `transmission` (type: `string`):

Filter by gearbox type.

## `max_results` (type: `integer`):

Maximum number of vehicles to return. <b>0</b> = no limit (full stock, ~1,900 units). Example: <code>10</code> for a quick, cheap test.

## `price_min` (type: `integer`):

Minimum sale price in EUR. Leave empty for no lower limit.

## `price_max` (type: `integer`):

Maximum sale price in EUR. Leave empty for no upper limit.

## `power_kw_min` (type: `integer`):

Minimum engine output in kilowatts. Leave empty for no lower limit.

## `power_kw_max` (type: `integer`):

Maximum engine output in kilowatts. Leave empty for no upper limit.

## `sort_by` (type: `string`):

Field used to order results from the API.

## `sort_direction` (type: `string`):

Sort order for the selected field.

## `page_size` (type: `integer`):

Vehicles per API request (1-100). 50 is a good default.

## `image_width` (type: `integer`):

Width in pixels of the vehicle render image from the SEAT CDN.<br><br>• <b>800 px</b> — default, good for web use<br>• <b>400 px</b> — smaller payload, faster runs<br>• <b>2048 px</b> — full resolution

## Actor input object example

```json
{
  "region": "",
  "model": "",
  "fuel_type": "",
  "body_type": "",
  "transmission": "",
  "max_results": 10,
  "sort_by": "PRICE_SALE",
  "sort_direction": "ASC",
  "page_size": 50,
  "image_width": 800
}
```

# Actor output Schema

## `overview` (type: `string`):

Dataset items (table view)

# 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 = {
    "max_results": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/seat-spain-stock-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 = { "max_results": 10 }

# Run the Actor and wait for it to finish
run = client.actor("rastriq/seat-spain-stock-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "max_results": 10
}' |
apify call rastriq/seat-spain-stock-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rastriq/seat-spain-stock-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/rJVXVK7oV3fa2mXeG/builds/PeZX07VBc7PuPCCFm/openapi.json