# Cinch Automotive Search Scraper (`alexist/cinch-automotive-search-scraper`) Actor

Scrape comprehensive used car data from Cinch.co.uk with 47+ vehicle fields. Extract specifications, pricing, financing quotes, mileage, and inventory details for automotive research, market analysis, and deal tracking.

- **URL**: https://apify.com/alexist/cinch-automotive-search-scraper.md
- **Developed by:** [Alex](https://apify.com/alexist) (community)
- **Categories:** Automation, Developer tools, Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Automotive Search Scraper: Extract UK Used Car Listings in Seconds

***

### What Is Cinch.co.uk?

Cinch.co.uk is the UK's leading online marketplace for used cars, offering thousands of vehicles from dealers and private sellers. The platform combines detailed inventory data with transparent pricing and financing options, making it a go-to resource for car buyers and automotive professionals. Manually extracting vehicle data from search results is tedious — the **Cinch Automotive Search Scraper** automates this process, delivering structured vehicle records at scale.

***

### Overview

The **Cinch Automotive Search Scraper** extracts detailed used car listings from Cinch search pages, transforming raw HTML into clean, structured records with 47+ data fields. It is ideal for:

- **Car dealers** monitoring competitor inventory and pricing
- **Automotive researchers** studying UK used car market trends
- **Data analysts** building vehicle price prediction models
- **Aggregator platforms** feeding used car data into comparison tools
- **Market researchers** tracking vehicle availability by make, model, and region

Key advantages include configurable item limits per URL, automatic handling of pagination, error resilience with `ignore_url_failures`, and comprehensive output covering specifications, pricing, and financing data.

***

### Input Format

The scraper accepts a JSON configuration object with three main parameters:

```json
{
    "urls": [
        "https://www.cinch.co.uk/used-cars/2-doors?pageNumber=2"
    ],
    "max_items_per_url": 200,
    "ignore_url_failures": true
}
```

| Parameter | Type | Description |
|---|---|---|
| `urls` | Array | URLs of Cinch search result pages to scrape (e.g., filtered by body type, doors, or price range) |
| `max_items_per_url` | Integer | Maximum vehicles extracted per URL (default: `100`, max: `200+`) |
| `ignore_url_failures` | Boolean | If `true`, scraper continues if some URLs fail; if `false`, stops at first error |

> **Tip:** Use filtered search URLs to target specific vehicle categories. For example, add `?pageNumber=2` to scrape multiple pages sequentially, or filter by body type (`/used-cars/2-doors`) or price range.

***

### Output Format

**Sample output**

```json
{
  "updated_at": "2026-07-27T15:47:22.000Z",
  "updated_by": "VehicleReservations.VehicleUnreserved",
  "first_published_date": "2026-06-19T15:46:44.654Z",
  "vehicle_id": "b28e490b-6e4e-45bc-84a6-70082138f80a",
  "model_year": 2018,
  "vehicle_year": 2018,
  "body_type": "Coupe",
  "colour": "BLACK",
  "doors": 2,
  "engine_capacity_cc": 898,
  "fuel_type": "Petrol",
  "vrm": "AE68EKP",
  "published": true,
  "is_reserved": false,
  "mileage": 76928,
  "seats": 2,
  "stock_type": "cinch",
  "trim": "Prime Sport",
  "variant": "0.9 Turbo Prime Sport Premium Plus 2dr Auto",
  "transmission_type": "Automatic",
  "miles_per_gallon": 56,
  "drive_type": "Rear-wheel drive",
  "tags": [],
  "discount_in_pence": 0,
  "deposit_contribution_in_pence": 0,
  "promotion_id": null,
  "price_including_admin_fee": 6999,
  "condition": "used",
  "inventory_type": "physical",
  "make": "smart",
  "price": 6900,
  "model": "fortwo coupe",
  "thumbnail_url": "https://eu.cdn.autosonshow.tv/2958/20984/AE68EKP/06_md.jpg",
  "site": "Corby",
  "engine_size": 898,
  "full_registration": "AE68EKP",
  "is_available": true,
  "selected_model": "fortwo coupe",
  "quote_type": "pcp",
  "quote_annual_miles": 8000,
  "quote_balance_in_pence": 490000,
  "quote_apr": 12.4,
  "quote_regular_payment_in_pence": 10135,
  "quote_term_months": 48,
  "quote_deposit_in_pence": 200000,
  "quote_charges_in_pence": 162980,
  "quote_residual_value_in_pence": 166500,
  "quote_excess_mileage": "12p",
  "from_url": "https://www.cinch.co.uk/used-cars/2-doors"
}
```

Each scraped vehicle returns a rich record with 47 fields covering specifications, pricing, financing, and inventory metadata:

#### Vehicle Identification & Metadata

| Field | Meaning |
|---|---|
| `Vehicle ID` | Unique Cinch identifier for the listing |
| `VRM` | Vehicle Registration Mark (UK license plate) |
| `Make` | Vehicle manufacturer (e.g., Ford, BMW) |
| `Model` | Specific model name (e.g., Focus, 3 Series) |
| `Trim` | Trim level or package (e.g., SE, Sport, Premium) |
| `Variant` | Engine/transmission variant details |
| `Selected Model` | The exact variant selected for quote (if applicable) |
| `Thumbnail URL` | Link to vehicle listing image |
| `Site` | Which Cinch site published the listing |
| `Stock Type` | Inventory classification (e.g., dealer stock, trade-in) |

#### Vehicle Specifications

| Field | Meaning |
|---|---|
| `Model Year` | Year of manufacture for the model generation |
| `Vehicle Year` | Registration year of the specific vehicle |
| `Body Type` | Classification (e.g., sedan, hatchback, SUV) |
| `Doors` | Number of doors (2, 4, 5) |
| `Seats` | Number of passenger seats |
| `Colour` | External paint color |
| `Engine Capacity (CC)` | Engine displacement in cubic centimeters |
| `Engine Size` | Alternative engine size notation |
| `Fuel Type` | Petrol, diesel, hybrid, electric, or other |
| `Transmission Type` | Manual or automatic |
| `Drive Type` | Front-wheel drive (FWD), rear-wheel drive (RWD), all-wheel drive (AWD) |
| `Miles Per Gallon` | Official fuel efficiency (MPG) rating |
| `Mileage` | Odometer reading at listing time |
| `Full Registration` | Complete registration details |
| `Condition` | Vehicle condition (e.g., good, excellent) |

#### Pricing & Promotions

| Field | Meaning |
|---|---|
| `Price` | Base asking price in GBP |
| `Price Including Admin Fee` | Total price after Cinch administration charges |
| `Discount (Pence)` | Promotional discount applied (in pence) |
| `Deposit Contribution (Pence)` | Dealer contribution towards deposit (in pence) |
| `Promotion ID` | Reference ID for active promotions |

#### Inventory Status

| Field | Meaning |
|---|---|
| `Published` | Whether the listing is publicly visible |
| `Is Available` | True if vehicle is in stock and available to purchase |
| `Is Reserved` | True if the vehicle has been reserved by a buyer |
| `Inventory Type` | Classification within Cinch's inventory system |
| `Updated At` | Timestamp of last inventory update |
| `Updated By` | User or system that made the last update |
| `First Published Date` | Original publication date of the listing |

#### Finance & Quote Details

| Field | Meaning |
|---|---|
| `Quote Type` | Type of financing offer (e.g., HP, PCP) |
| `Quote APR` | Annual Percentage Rate for the quoted finance |
| `Quote Deposit (Pence)` | Required upfront deposit (in pence) |
| `Quote Regular Payment (Pence)` | Monthly payment amount (in pence) |
| `Quote Term (Months)` | Contract duration in months (e.g., 36, 48) |
| `Quote Balance (Pence)` | Outstanding balance after term (in pence) |
| `Quote Annual Miles` | Permitted annual mileage allowance |
| `Quote Excess Mileage` | Charge per excess mile beyond allowance |
| `Quote Residual Value (Pence)` | Predicted end-of-term vehicle value (in pence) |
| `Quote Charges (Pence)` | Additional finance charges (in pence) |

#### Tags & Classification

| Field | Meaning |
|---|---|
| `Tags` | Searchable tags (e.g., "one-owner", "service-history", "low-mileage") |

***

### How to Use

1. **Build your search URL** — Navigate to Cinch.co.uk and apply filters (body type, price, mileage, region). Copy the resulting URL.
2. **Add pagination (optional)** — Append `?pageNumber=2`, `pageNumber=3` etc. to scrape multiple pages in one run.
3. **Configure the input** — Paste URLs into the `urls` array. Set `max_items_per_url` based on how many vehicles per page you need (typically 10–50 per page).
4. **Enable error handling** — Set `ignore_url_failures: true` for batch runs to prevent interruptions from temporary network issues.
5. **Run the scraper** — Launch the actor and monitor the execution log in real-time.
6. **Export & analyze** — Download results as JSON, CSV, or Excel for integration into spreadsheets, databases, or analysis tools.

**Best practices:**

- Use filtered URLs to target specific vehicle segments (e.g., electric cars, SUVs under £15,000).
- Combine multiple URLs to sample different regions or price ranges in a single run.
- Set `max_items_per_url` conservatively first; increase if you need more volume.
- Store results in a database to track price changes and inventory turnover over time.

***

### Use Cases & Business Value

- **Price benchmarking:** Compare vehicle valuations across dealers and track price trends month-over-month
- **Inventory monitoring:** Track available stock by make, model, body type, or region in real-time
- **Finance offer analysis:** Extract APR, deposit, and payment data to understand competitive financing terms
- **Market research:** Identify which vehicle segments have highest demand, mileage ranges, and condition ratings
- **Predictive modeling:** Build machine-learning models to forecast used car prices based on Cinch market data
- **Aggregator feeds:** Continuously supply fresh vehicle data to automotive comparison platforms

The Cinch Automotive Search Scraper eliminates manual copy-paste workflows, delivering consistent, actionable vehicle intelligence that drives better pricing decisions, competitive positioning, and market insights.

***

### Conclusion

The **Cinch Automotive Search Scraper** is a powerful tool for anyone needing reliable, structured used car data from the UK's largest online marketplace. With 47+ fields spanning specifications, pricing, financing, and inventory status, it enables data-driven automotive research and business intelligence. Automate your vehicle data collection and unlock competitive advantages in the used car market.

# 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://www.cinch.co.uk/used-cars/2-doors?pageNumber=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 100
}
```

# 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://www.cinch.co.uk/used-cars/2-doors?pageNumber=2"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("alexist/cinch-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://www.cinch.co.uk/used-cars/2-doors?pageNumber=2"],
    "ignore_url_failures": True,
    "max_items_per_url": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("alexist/cinch-automotive-search-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 '{
  "urls": [
    "https://www.cinch.co.uk/used-cars/2-doors?pageNumber=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 100
}' |
apify call alexist/cinch-automotive-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,alexist/cinch-automotive-search-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/fwk6dH4tcy6bE4264/builds/rpJdiU5czPmxmNRTz/openapi.json