# Spoticar Cars Search Scraper (`stealth_mode/spoticar-cars-search-scraper`) Actor Scrape Spoticar.com's certified pre-owned car inventory with ease. Extract 40+ fields per listing including pricing, specs, dealer info, photos, and VIN — perfect for automotive analysts, dealers, and price comparison platforms. - **URL**: https://apify.com/stealth\_mode/spoticar-cars-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, NaN 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 ## Coches.net Car Search Scraper: Extract Spanish Auto Listings at Scale --- ### What Is Coches.net? Coches.net is one of Spain's largest online car marketplaces, hosting thousands of new and used vehicle listings from both private sellers and professional dealers. Manually extracting listing data for market analysis or inventory comparison is impractical at scale. The **Coches.net Car Search Scraper** automates this entirely, turning search result pages into structured, exportable datasets. --- ### Overview This scraper processes Coches.net search result URLs and extracts detailed records for each listed vehicle. It is suited for: - **Automotive dealers** monitoring competitor pricing and inventory - **Market analysts** tracking price trends by make, model, or region - **Aggregator platforms** feeding data into custom car search tools - **Researchers** studying the Spanish used car market The scraper supports pagination, bulk URL input, configurable item limits, and proxy routing for reliable, uninterrupted collection. --- ### Input Format ```json { "urls": [ "https://www.coches.net/search/?Section1Id=2500&pg=2" ], "ignore_url_failures": true, "max_items_per_url": 50 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | One or more Coches.net search result URLs. Supports bulk paste or single entry. Example: `https://www.coches.net/search/?Section1Id=2500&pg=2` | | `ignore_url_failures` | `boolean` | If `true`, failed URLs are skipped rather than stopping the entire run. Recommended for bulk jobs. Default: `true` | | `max_items_per_url` | `integer` | Maximum listings to collect per URL. Default: `20`. Increase up to available listings per page. | > **Tip:** To scrape multiple pages, add each paginated URL separately (e.g., `?pg=1`, `?pg=2`). Use search filters in the URL to narrow results by make, fuel type, or province. *** ### Output Format ```json { "price_average_indicator": 29500, "body_type_id": 6, "creation_date": "2025-08-14T18:45:10Z", "environmental_label": "C", "hp": 129, "financed_price": 26800, "financing_info": { "lender": "santander", "instalment": 382.13883567762076, "terms": 120, "tae": 12.5425, "entry": 0 }, "fuel_type": "Gasolina", "fuel_type_id": 2, "has_online_financing": false, "has_reservation": true, "hide_phone": false, "has_warranty": true, "id": "61258027", "img": "https://a.ccdn.es/cnet/vehicles/18388610/91ca917a-347c-4354-9264-9d2169f841cd.jpg", "img_url": "https://a.ccdn.es/cnet/vehicles/18388610/91ca917a-347c-4354-9264-9d2169f841cd.jpg/359x269cut/", "includes_taxes": true, "is_certified": false, "is_financed": true, "is_urgent": false, "is_professional": true, "is_url_semantic": true, "km": 46440, "location": { "province_ids": [ 15 ], "region_id": 12, "region_literal": "Galicia", "main_province": "A Coruña", "main_province_id": 15, "city_id": 15058, "city_literal": "Oleiros" }, "make": "VOLVO", "make_id": 48, "model": "XC40", "model_id": 1233, "pack": { "legacy_id": 30, "type": "expert" }, "price": 28800, "url": "/volvo-xc40-15-t2-core-auto-5p-gasolina-2024-en-a-coruna-61258027-covo.aspx", "offer_type": { "id": 0, "literal": "Ocasión" }, "phone": "689525145", "photos": [ "https://a.ccdn.es/cnet/vehicles/18388610/91ca917a-347c-4354-9264-9d2169f841cd.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/991f7aac-fada-40bb-ae19-272a39bec0a3.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/3ef86fbf-5263-48cf-8b74-97adf5ccb283.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/d22e38eb-8024-4bd8-9188-c5465b87e1f2.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/d0bf914f-9be9-480c-9c57-817190965b8d.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/e882de55-9310-4662-a8ef-75b487aa8ac4.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/6e2a4593-187d-4601-b2a9-7d0ce3443c9a.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/87514673-948f-419a-8edc-9d07d04774b4.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/6cc05c60-e8f9-41e7-876e-f2efc03724d5.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/7c9e839a-8f46-43ef-bd44-1c7c5e3a1ae6.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/0b600422-ca9a-4bdf-a108-c19710875b40.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/b17ef47f-faf6-4967-9158-f66f9d0cc7af.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/64364dcc-04ff-4529-af51-b76e3995d2b9.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/f7206011-1bd5-43ba-8461-fdcddbb8c908.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/055f996d-2293-41fa-91cd-c3d34814de0c.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/1c8ae890-fef0-42f7-9ae9-1c5b46654f39.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/bc4c9d36-5c7f-4000-8fcc-1e79de03d3d5.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/66e3c66e-7c9e-4d00-a77c-f08932b3bc78.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/ed0ed0af-aa13-4e68-949f-9895d111e815.jpg", "https://a.ccdn.es/cnet/vehicles/18388610/c7d9d2c5-305d-41cc-9162-8a5a8246c169.jpg" ], "province_id": 15, "publication_date": "2026-04-29T12:01:35Z", "price_rank_indicator": 3, "specific_fuel_type_id": 2, "tax_type_id": 1, "title": "VOLVO XC40 1.5 T2 Core Auto", "videos": [], "warranty_id": 4, "warranty_months": 24, "year": 2023, "seller": { "name": "MERENAUTO ", "is_professional": true, "contract_id": "111702", "pack": { "legacy_id": 30, "type": "expert" }, "ratings": { "average": 4.6, "tags": [], "total_reviews": 30 } }, "list_position": 1 } ``` Each vehicle listing returns a structured record with 45+ fields: #### Identification & Listing Info | Field | Meaning | |---|---| | `ID` | Unique internal Coches.net listing identifier | | `Title` | Full listing title as displayed (e.g., "Seat Ibiza 1.0 TSI 95cv Style") | | `URL` | Direct link to the listing page | | `Is URL Semantic` | Whether the URL uses a human-readable slug | | `Publication Date` | Date the listing was published | | `Creation Date` | Date the record was created in the system | | `List Position` | Position of the listing within the search results | | `Offer Type` | Type of offer (e.g., standard, urgent, featured) | | `Is Urgent` | Whether the seller has marked the listing as urgent | #### Vehicle Specs | Field | Meaning | |---|---| | `Make` | Brand name (e.g., Toyota, BMW) | | `Make ID` | Internal brand identifier | | `Model` | Model name (e.g., Corolla, Serie 3) | | `Model ID` | Internal model identifier | | `Year` | Manufacturing or registration year | | `KM` | Odometer reading in kilometers | | `HP` | Engine power in horsepower | | `Fuel Type` | Fuel category label (e.g., Gasoline, Diesel, Electric) | | `Fuel Type ID` | Internal fuel type code | | `Specific Fuel Type ID` | More granular fuel sub-type identifier | | `Body Type ID` | Body style code (e.g., sedan, SUV, hatchback) | | `Environmental Label` | Spanish DGT eco label (e.g., 0, ECO, C, B) | | `Pack` | Trim level or equipment pack name | #### Pricing & Financing | Field | Meaning | |---|---| | `Price` | Listed sale price | | `Financed Price` | Monthly payment if financed | | `Financing Info` | Financing terms or conditions | | `Has Online Financing` | Whether online financing is available | | `Is Financed` | Whether the listing shows a financed price | | `Includes Taxes` | Whether the price includes taxes (IVA) | | `Tax Type ID` | Tax regime applied to the listing | | `Price Average Indicator` | Relative price vs. market average | | `Price Rank Indicator` | Ranking of price competitiveness | #### Seller & Contact | Field | Meaning | |---|---| | `Seller` | Seller name and metadata | | `Is Professional` | Whether the seller is a dealership/professional | | `Is Certified` | Whether the vehicle has a certified pre-owned status | | `Phone` | Seller contact phone number | | `Hide Phone` | Whether the phone number is hidden on the listing | | `Province ID` | Province code of the seller/vehicle location | | `Location` | Human-readable location string | #### Warranty & Reservation | Field | Meaning | |---|---| | `Has Warranty` | Whether a warranty is offered | | `Warranty ID` | Warranty type identifier | | `Warranty Months` | Duration of warranty in months | | `Has Reservation` | Whether the listing supports online reservation | #### Media | Field | Meaning | |---|---| | `Image` | Primary listing image (thumbnail object) | | `Image URL` | Direct URL to the main image | | `Photos` | Array of all listing photo URLs | | `Videos` | Array of video URLs if present | *** ### How to Use 1. **Build your search URL** — Filter by make, body type, fuel, price range, or province on Coches.net, then copy the search results URL. 2. **Add to `urls`** — Paste one or more paginated URLs into the array. 3. **Set item limit** — Adjust `max_items_per_url` to match how many listings you need (typical pages show 20–40 results). 4. **Run and export** — Download results as JSON, CSV, or Excel. **Tips:** - Append `&pg=N` to collect across multiple pages. - Use `ignore_url_failures: true` for large batch runs to avoid interruptions from occasional timeouts. - The `Environmental Label` field is especially useful for filtering EV and hybrid inventory. *** ### Use Cases & Business Value - **Price intelligence:** Compare how your inventory is priced vs. the broader market using `Price Rank Indicator` and `Price Average Indicator` - **Inventory monitoring:** Track new listings by make/model/region automatically - **Lead generation:** Identify urgent or below-market listings for resale opportunities - **Research:** Analyze depreciation curves, regional demand, or EV adoption rates using structured historical data *** ### Conclusion The **Coches.net Car Search Scraper** gives automotive professionals and researchers direct access to Spain's car market data without manual effort. With granular fields covering specs, pricing, financing, seller credentials, and media, it supports everything from one-off analysis to automated data pipelines. Run it on any Coches.net search URL and get clean, structured results in minutes. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Cars 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://www.spoticar.com/shop/search-inventory?zipcode=10000&tier=&recordType=&snifilter-dealer-radius-range=min:0,max:3000&brand=&" ], "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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://www.spoticar.com/shop/search-inventory?zipcode=10000&tier=&recordType=&snifilter-dealer-radius-range=min:0,max:3000&brand=&" ], "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/spoticar-cars-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://www.spoticar.com/shop/search-inventory?zipcode=10000&tier=&recordType=&snifilter-dealer-radius-range=min:0,max:3000&brand=&"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/spoticar-cars-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://www.spoticar.com/shop/search-inventory?zipcode=10000&tier=&recordType=&snifilter-dealer-radius-range=min:0,max:3000&brand=&" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/spoticar-cars-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/spoticar-cars-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Spoticar Cars Search Scraper", "description": "Scrape Spoticar.com's certified pre-owned car inventory with ease. Extract 40+ fields per listing including pricing, specs, dealer info, photos, and VIN — perfect for automotive analysts, dealers, and price comparison platforms.", "version": "0.0", "x-build-id": "Dg4iWy7r2bZjdcuTU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~spoticar-cars-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-spoticar-cars-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~spoticar-cars-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-spoticar-cars-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~spoticar-cars-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-spoticar-cars-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 Cars list urls to scrape", "type": "array", "description": "Add the URLs of the Cars 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 } } } } } } } } } } ```