# Cinch.co.uk Vehicle Scraper (`shahidirfan/cinch-co-uk-vehicle-scraper`) Actor Extract live used car listings from Cinch.co.uk instantly. Get vehicle specs, prices, mileage, condition, images & dealer details. Ideal for price monitoring, automotive market analysis, inventory benchmarking & competitive research. ETL-ready data. - **URL**: https://apify.com/shahidirfan/cinch-co-uk-vehicle-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (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 Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Cinch.co.uk Used Car Scraper Extract used car listings from [Cinch.co.uk](https://www.cinch.co.uk/used-cars) — the UK's leading online car retailer. Search by make, model, keyword, or provide a direct Cinch URL. Collect vehicle details, pricing, specifications, and dealer information at scale. --- ### Features - Search by **make**, **model**, **keyword**, or direct **URL** - Extracts full vehicle specifications: make, model, year, body type, fuel type, transmission, mileage, engine size, colour, doors, seats - Captures **pricing** (vehicle price + total price including admin fee) and any active discounts - Includes **finance quote data** (monthly payment, deposit, APR, term) - Outputs **direct listing URLs** and **thumbnail image URLs** - Handles **pagination** automatically — collect from 1 to thousands of vehicles - Respects result limits and page caps for controlled, cost-effective runs - No browser required — uses Cinch's native search API for maximum speed and reliability --- ### Use Cases - **Car market research** — track pricing trends across makes and models - **Competitive intelligence** — monitor stock levels and pricing changes - **Price comparison** — compare Cinch pricing against other UK car retailers - **Investment analysis** — identify underpriced or fast-moving stock - **Lead generation** — build datasets of available vehicles by location or type - **Finance analysis** — extract PCP/HP finance data across the inventory --- ### Input Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `startUrl` | String | No | Direct Cinch URL (e.g. `https://www.cinch.co.uk/used-cars/bmw`). Takes priority over all other filters. | | `make` | String | No | Vehicle manufacturer (e.g. `BMW`, `Audi`, `Ford`). Used if no Start URL. | | `model` | String | No | Vehicle model (e.g. `3 Series`, `A3`). Use with Make only. | | `keyword` | String | No | Free-text keyword search (e.g. `electric SUV`, `automatic diesel`). Used if no URL or Make. | | `results_wanted` | Integer | No | Maximum number of listings to collect. Default: `20`. | | `max_pages` | Integer | No | Maximum search result pages to fetch (each page has up to 60 vehicles). Default: `10`. | | `proxyConfiguration` | Object | No | Apify Proxy settings. Datacenter proxies are sufficient. | **Input priority**: `startUrl` → `make/model` → `keyword` → all vehicles --- ### Supported URL Patterns All of the following Cinch URL formats are supported as `startUrl`: ```` https://www.cinch.co.uk/used-cars https://www.cinch.co.uk/used-cars/bmw https://www.cinch.co.uk/used-cars/audi/a3 https://www.cinch.co.uk/used-cars/ford/focus/hatchback ```` --- ### Output Data Each vehicle listing contains the following fields (only fields with real values are included — no null fields): | Field | Type | Description | |---|---|---| | `make` | String | Vehicle manufacturer | | `model` | String | Model name | | `trim` | String | Trim level (e.g. M Sport, S Line) | | `variant` | String | Full variant description | | `year` | Integer | Registration year | | `bodyType` | String | Body style (e.g. Hatchback, SUV, Estate) | | `colour` | String | Exterior colour | | `fuelType` | String | Fuel type (Petrol, Diesel, Electric, Hybrid) | | `transmission` | String | Manual or Automatic | | `driveType` | String | Front/Rear/All-wheel drive | | `mileage` | Integer | Odometer reading (miles) | | `engineCapacityCc` | Integer | Engine size in cc | | `milesPerGallon` | Number | Fuel economy (MPG) | | `doors` | Integer | Number of doors | | `seats` | Integer | Number of seats | | `price` | Number | Vehicle price (£), excluding admin fee | | `priceIncludingAdminFee` | Number | Total price (£) including admin fee | | `discountAmount` | Number | Discount applied (£), if any | | `registration` | String | Vehicle registration mark (VRM) | | `condition` | String | Vehicle condition | | `isReserved` | Boolean | Whether vehicle is reserved | | `dealerSite` | String | Dealer site name | | `stockType` | String | Stock sourcing type | | `thumbnailUrl` | String | URL of vehicle thumbnail image | | `vehicleId` | String | Unique Cinch vehicle identifier | | `url` | String | Direct link to the listing on Cinch.co.uk | | `finance` | Object | PCP/HP finance quote details (if available) | --- ### Sample Output ```json { "make": "BMW", "model": "3 Series", "trim": "M Sport", "variant": "330e M Sport 5dr Step Auto", "year": 2022, "bodyType": "Estate", "colour": "GREY", "fuelType": "Petrol plug-in hybrid", "transmission": "Automatic", "driveType": "Rear-wheel drive", "mileage": 31703, "engineCapacityCc": 1998, "milesPerGallon": 201, "doors": 5, "seats": 5, "price": 22900, "priceIncludingAdminFee": 22999, "registration": "WA22OLR", "condition": "used", "isReserved": false, "dealerSite": "Thurleigh", "stockType": "partner_sourced", "thumbnailUrl": "https://eu.cdn.autosonshow.tv/7077/20503/WA22OLR/04_md.jpg", "vehicleId": "2eed5c7a-2d67-4ed4-848d-71aecd900ea9", "url": "https://www.cinch.co.uk/used-cars/bmw/3-series/2eed5c7a-2d67-4ed4-848d-71aecd900ea9", "finance": { "type": "pcp", "monthlyPayment": 374.07, "deposit": 2290, "apr": 12.4, "termMonths": 48, "annualMiles": 8000 } } ```` *** ### Usage Examples #### Search by Make ```json { "make": "BMW", "results_wanted": 50 } ``` #### Search by Make and Model ```json { "make": "Audi", "model": "A3", "results_wanted": 30 } ``` #### Search by Direct URL ```json { "startUrl": "https://www.cinch.co.uk/used-cars/ford/focus", "results_wanted": 100, "max_pages": 5 } ``` #### Search by Keyword ```json { "keyword": "electric SUV", "results_wanted": 20 } ``` #### All Available Vehicles ```json { "results_wanted": 200, "max_pages": 4 } ``` *** ### Tips - **No Start URL or filters?** The scraper fetches all available vehicles (8,000+). Use `results_wanted` to limit the output. - **Use make/model together** for the most targeted results. - **Each page contains up to 60 vehicles** — set `max_pages` to control the maximum scope. - **Finance data** is included automatically whenever Cinch provides a PCP/HP quote for a vehicle. - **Null fields are excluded** from output — every field in your dataset contains real data. *** ### Integrations - **Apify Dataset** — Download results as JSON, CSV, XML, or Excel - **Apify API** — Trigger runs and retrieve data via REST API - **Zapier / Make** — Connect to 5,000+ apps for automation - **Google Sheets** — Use the Apify Google Sheets integration to export data directly *** ### FAQ **Q: Do I need an API key or login for Cinch?** A: No. The scraper uses Cinch's public search API. No credentials are required. **Q: How many vehicles can I scrape?** A: Cinch has approximately 8,000–9,000 vehicles at any time. You can collect all of them by removing the `results_wanted` limit. **Q: How often does Cinch's inventory update?** A: Cinch updates vehicle availability in near real-time. Schedule this actor to run daily for fresh data. **Q: Why are some fields missing from a record?** A: Only fields with actual values are included in the output. Fields that Cinch does not provide for a specific vehicle are omitted rather than being set to `null`. **Q: Can I filter by body type, fuel type, or price?** A: Yes — use the `startUrl` parameter with a pre-filtered Cinch URL (apply your filters on the Cinch website first, then copy the URL). *** ### Legal Notice This scraper collects publicly available data from Cinch.co.uk for research and analysis purposes. Always review [Cinch's Terms of Service](https://www.cinch.co.uk/terms-conditions) before using scraped data commercially. The operator is solely responsible for ensuring their use of this tool complies with applicable laws and Cinch's policies. # Actor input Schema ## `startUrl` (type: `string`): A direct Cinch.co.uk used-cars URL (e.g. https://www.cinch.co.uk/used-cars/bmw or https://www.cinch.co.uk/used-cars/audi/a3). Takes priority over Make/Model/Keyword. ## `make` (type: `string`): Car manufacturer, e.g. BMW, Audi, Ford. Used when Start URL is not provided. ## `model` (type: `string`): Car model, e.g. 3 Series, A4, Focus. Only used together with Make. ## `results_wanted` (type: `integer`): Maximum number of vehicle listings to collect. ## `max_pages` (type: `integer`): Safety cap on the number of result pages to fetch (each page has up to 60 vehicles). ## `proxyConfiguration` (type: `object`): Use Apify Proxy for reliable scraping. Datacenter proxies are sufficient for Cinch.co.uk. ## Actor input object example ```json { "startUrl": "https://www.cinch.co.uk/used-cars/bmw", "make": "BMW", "results_wanted": 20, "max_pages": 10, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrl": "https://www.cinch.co.uk/used-cars/bmw", "make": "BMW" }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/cinch-co-uk-vehicle-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 = { "startUrl": "https://www.cinch.co.uk/used-cars/bmw", "make": "BMW", } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/cinch-co-uk-vehicle-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 '{ "startUrl": "https://www.cinch.co.uk/used-cars/bmw", "make": "BMW" }' | apify call shahidirfan/cinch-co-uk-vehicle-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/cinch-co-uk-vehicle-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Cinch.co.uk Vehicle Scraper", "description": "Extract live used car listings from Cinch.co.uk instantly. Get vehicle specs, prices, mileage, condition, images & dealer details. Ideal for price monitoring, automotive market analysis, inventory benchmarking & competitive research. ETL-ready data.", "version": "0.0", "x-build-id": "RGuGvyZgDUwtLrpkP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~cinch-co-uk-vehicle-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-cinch-co-uk-vehicle-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/shahidirfan~cinch-co-uk-vehicle-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-cinch-co-uk-vehicle-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/shahidirfan~cinch-co-uk-vehicle-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-cinch-co-uk-vehicle-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": { "startUrl": { "title": "Start URL", "type": "string", "description": "A direct Cinch.co.uk used-cars URL (e.g. https://www.cinch.co.uk/used-cars/bmw or https://www.cinch.co.uk/used-cars/audi/a3). Takes priority over Make/Model/Keyword." }, "make": { "title": "Make (if not using Start URL)", "type": "string", "description": "Car manufacturer, e.g. BMW, Audi, Ford. Used when Start URL is not provided." }, "model": { "title": "Model (if not using Start URL)", "type": "string", "description": "Car model, e.g. 3 Series, A4, Focus. Only used together with Make." }, "results_wanted": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Maximum number of vehicle listings to collect.", "default": 20 }, "max_pages": { "title": "Maximum pages", "minimum": 1, "type": "integer", "description": "Safety cap on the number of result pages to fetch (each page has up to 60 vehicles).", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy for reliable scraping. Datacenter proxies are sufficient for Cinch.co.uk.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```