# SGCarMart Used Car Scraper — Prices, COE/OMV/ARF & Dealer Leads (`scrapesage/sgcarmart-used-car-scraper`) Actor

Scrape SGCarMart used-car listings: price, depreciation, COE left, OMV, ARF, PARF/dereg value, road tax, mileage, specs and the full photo gallery — plus dealer name, phone and address as leads. Filter by vehicle type or paste any search URL. Monitor mode returns only new & changed cars.

- **URL**: https://apify.com/scrapesage/sgcarmart-used-car-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** Lead generation, E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 car listing scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## SGCarMart Used Car Scraper — Prices, COE/OMV/ARF & Dealer Leads

Extract **complete used-car data from [SGCarMart](https://www.sgcarmart.com)** — Singapore's #1 car marketplace. Get every field that matters for the Singapore market: **asking price, annual depreciation, COE time left and expiry date, OMV, ARF, PARF/deregistration value, road tax, mileage, engine, power and full specs**, the **complete photo gallery**, and — for lead generation — the **dealer's name, phone number, address and profile**.

No login, no cookies, no browser — fast structured-data extraction with **Singapore residential proxies** built in.

### Why this SGCarMart scraper?

Most car scrapers grab the few fields on the listing card and stop there. This actor reads SGCarMart's server-rendered data directly and ships the **richest dataset in the category** — every Singapore-specific tax/registration field, the whole photo gallery, and the dealer turned into a contactable B2B lead.

| Data | Typical scrapers | This actor |
|---|---|---|
| Price, depreciation/yr, mileage, COE left | ✅ | ✅ |
| COE expiry date, OMV, ARF, PARF/dereg value, road tax | partial | ✅ |
| Power, curb weight, engine cap, manufacture year, owners | partial | ✅ |
| Full photo gallery (all images, full-size) | ❌ first photo only | ✅ |
| **Dealer phone + address + profile (leads)** | ❌ | ✅ |
| Dealer tier (Premium / Consignment / Warranty / Basic) + direct-owner flag | ❌ | ✅ |
| Monthly installment estimate | ❌ | ✅ |
| Clean **parsed numeric** fields (S$ → numbers, dates → ISO) | ❌ | ✅ |
| **Monitor mode** — only new & changed listings, with price-drop flags | ❌ | ✅ |
| Filter by vehicle type **or paste any search URL** | partial | ✅ |
| No start fee | ❌ | ✅ |

### Use cases

- **Dealer lead generation** — every listing carries the selling dealer's name, phone, address and profile. Filter by make, price or vehicle type and build a targeted list of motor traders for advertising, finance, insurance, warranty, grooming, parts or trade-in outreach.
- **Pricing & market intelligence** — track asking prices, depreciation, and price-to-OMV ratios across makes, models and body types. Spot under/over-priced cars and COE-driven market shifts.
- **Residual-value & finance modelling** — feed OMV, ARF, PARF/dereg value, COE expiry and depreciation into loan-pricing, insurance and residual-value models.
- **Inventory & competitor monitoring** — watch a specific dealer (`dl=` code), model, or the whole market for new listings and price drops with **monitor mode**.
- **Valuation tools & dashboards** — power price-alert apps, dealer dashboards and proptech-style automotive products with clean, structured Singapore car data.

### How to use

1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **SGCarMart Used Car Scraper**, then either leave the input as-is to scrape the newest listings, choose **vehicle types**, or paste SGCarMart **search/listing URLs** (set any filters on sgcarmart.com and copy the URL). Click **Start**.
3. Watch results stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2).

### Input

```json
{
    "searchUrls": ["https://www.sgcarmart.com/used-cars/listing?vts[]=9"],
    "vehicleTypes": ["9"],
    "availability": "available",
    "maxItems": 100,
    "scrapeDetails": true,
    "monitorMode": false
}
````

- **searchUrls** — SGCarMart used-car listing/search URLs. Configure make, model, price, depreciation, COE or sorting on the site and paste the resulting URL; the scraper paginates through every result.
- **startUrls** — individual car detail-page URLs (`/used-cars/info/…`) to scrape only specific cars.
- **vehicleTypes** *(multiselect)* — SUV, MPV, Hatchback, Luxury/Mid-Sized Sedan, Sports, Hybrid, Electric, Van, Truck, and more. Used when building the search from filters.
- **availability** *(default `available`)* — `available`, `sold`, or `all`.
- **dealerCode** — scrape only one dealer's inventory by SGCarMart dealer code (the `dl=` value).
- **maxItems** *(default 100)* — cap the number of cars; `0` = no limit.
- **scrapeDetails** *(default true)* — open each car's detail page for OMV, ARF, dereg value, road tax, COE expiry, power, curb weight, the full gallery and the dealer's phone/address. Turn off for a fast, cheap listing-only run.
- **monitorMode** *(default false)* — only output listings that are **new or changed** since the last run for the same input (see below).
- **proxyConfiguration** — defaults to Singapore residential proxies, which are strongly recommended: SGCarMart is Cloudflare-protected and geofenced to Singapore, so datacenter or non-SG IPs are typically blocked. Optional, but keep the default unless you have a reason to change it.

### Output

One record per car. With `scrapeDetails` on you get the full set below; with it off you get the listing-level subset (price, depreciation, mileage, COE left, make/model, body type, photo, dealer name).

```json
{
    "listingId": 1510044,
    "url": "https://www.sgcarmart.com/used-cars/info/toyota-hiace-30m-1510044",
    "make": "Toyota",
    "model": "Hiace",
    "title": "Toyota Hiace 3.0M",
    "price": 36800,
    "depreciationPerYear": 14360,
    "currency": "SGD",
    "installmentPerMonth": 1227,
    "manufacturedYear": 2018,
    "registrationDate": "2019-01-29",
    "coeExpiryDate": "2039-01-28",
    "coeExpiryIsEstimated": false,
    "coeTimeLeft": "2y 7m",
    "coeMonthsLeft": 31,
    "mileageKm": 76000,
    "mileagePerYearKm": 10300,
    "omv": 28136,
    "arf": 1407,
    "coeAmount": 23457,
    "deregValue": 6176,
    "roadTaxPerYear": null,
    "engineCapacityCc": 2982,
    "powerKw": null,
    "curbWeightKg": 1700,
    "driveRangeKm": null,
    "transmission": "Manual",
    "fuelType": "Diesel",
    "numOwners": 1,
    "bodyType": "Van",
    "vehicleScheme": null,
    "inspectionGrade": null,
    "isDirectOwner": false,
    "status": "Available",
    "adType": "Premium",
    "listedDate": "2026-06-12",
    "description": "2019 Toyota Hiace 3.0 Turbo diesel 5MT…",
    "features": "3.0L turbo diesel engine, 5-speed manual transmission…",
    "accessories": "Factory audio system, power windows, air conditioning…",
    "primaryImageUrl": "https://i.i-sgcm.com/cars_used/202606/1510044_1.jpg",
    "imageUrls": ["https://i.i-sgcm.com/cars_used/202606/1510044_1.jpg", "…_2.jpg", "…_9.jpg"],
    "dealerName": "Drivechoice Motors Pte Ltd",
    "dealerCode": 4832,
    "dealerType": "Basic",
    "dealerIsPremium": false,
    "dealerPhone": "69514476",
    "dealerPhoneDisplay": "6951 4476",
    "dealerAddress": "39 Woodlands Close #03-22 Mega @ Woodlands",
    "dealerPostalCode": "737856",
    "dealerWebsite": null,
    "dealerProfileUrl": "https://www.sgcarmart.com/directory/merchant.php?MID=19073",
    "dealerMapUrl": "https://www.sgcarmart.com/directory/merchant_map.php?MID=19073",
    "scrapedAt": "2026-06-12T00:00:00.000Z"
}
```

The full record also includes `originalRegistrationDate`, `opcScheme`, `electricMotor`, `staEvaluation`, `warranty`, `ownerConsignment`, `tag`, `postedDate`, `updatedDate`, `dealerDescription`, `mileagePerYearKm` and `viewSimilarUrl`. `dealerType` may be a comma-separated combination of tiers (e.g. `"Premium, Warranty"`). `coeExpiryDate` is exact when the page publishes a vehicle lifespan; otherwise it's estimated from COE time left and flagged with `coeExpiryIsEstimated: true`.

#### What to expect (field coverage)

SGCarMart data is dealer-entered, so a few fields appear only when the dealer filled them in. All monetary fields are parsed to plain numbers in **SGD**, and dates to ISO format.

Column names below are the **literal output keys**.

| Field group | Always present | Present when published |
|---|---|---|
| Identity & price | make, model, title, price, depreciationPerYear, installmentPerMonth, url, listingId | — |
| Registration & COE | registrationDate, coeTimeLeft, coeMonthsLeft, coeExpiryDate | manufacturedYear (with detail). `coeExpiryDate` is exact for vehicles that publish a lifespan, otherwise estimated from COE time left (`coeExpiryIsEstimated: true`). |
| SG tax (detail) | — | omv, arf, coeAmount, deregValue, roadTaxPerYear (some commercial vehicles show road tax `N.A.`) |
| Specs | mileageKm, transmission, fuelType, engineCapacityCc, isDirectOwner | powerKw, curbWeightKg, driveRangeKm (EVs), vehicleScheme, inspectionGrade |
| Dealer (detail) | dealerName | dealerPhone, dealerAddress, dealerPostalCode, dealerProfileUrl, dealerMapUrl, dealerWebsite, dealerType (may be comma-joined) |
| Media | primaryImageUrl | imageUrls (full gallery) |

A blank field means the dealer didn't publish it for that car — never that scraping failed. Nothing is dropped, so you always get the richest record available.

### Monitor only new & changed listings

Turn on **monitorMode** to output only listings that are **new** or have **changed** (e.g. a price drop) since the previous run for the same input. Each changed row is tagged `monitorStatus` (`new`, `price_drop`, `price_increase`, `changed`) with the `previousPrice`. State is stored across runs, so it pairs perfectly with **[Apify Schedules](https://docs.apify.com/platform/schedules)** — the schedule triggers the run, monitor mode decides what's worth saving. The two work together; there's no conflict.

### Automate & schedule

Run this actor on autopilot and pull results into your own stack:

- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/hourly to track a model, dealer or the whole market; combine with monitor mode for new-listing and price-drop alerts.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes.

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/sgcarmart-used-car-scraper').call({
    vehicleTypes: ['9'],
    maxItems: 200,
    scrapeDetails: true,
    monitorMode: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} used cars & dealer leads`);
```

### Integrate with any app

Connect the dataset to 5,000+ apps — no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new dealer leads straight into your CRM.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored model or dealer lists a car or drops a price.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.

### Use with AI assistants (MCP)

The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find SUVs under $80k with low depreciation on SGCarMart and list the dealers' phone numbers" and let it run the scraper for you.

### More scrapers from scrapesage

Build a complete **lead-gen & market-intelligence stack**:

- **[Airbnb Scraper](https://apify.com/scrapesage/airbnb-scraper)** — listings, prices, and availability.
- **[Bark Listing Scraper](https://apify.com/scrapesage/bark-listing-scraper)** — service-provider leads from Bark.
- **[Facebook Ad Library Scraper](https://apify.com/scrapesage/facebook-ad-library-scraper)** — competitor ad intelligence on Meta & Instagram (see which dealers advertise what).
- **[Google Ads Transparency Scraper](https://apify.com/scrapesage/google-ads-transparency-scraper)** — who's advertising what on Google.
- **[LinkedIn Jobs Scraper](https://apify.com/scrapesage/linkedin-jobs-scraper)** — job postings as hiring-intent signals.
- **[Eventbrite Scraper](https://apify.com/scrapesage/eventbrite-scraper)** — events plus organizer leads (ticket prices, emails, socials).
- **[Sched Conference Scraper](https://apify.com/scrapesage/sched-conference-scraper)** — speakers, sessions and sponsors from Sched events.
- **[Whova Event Scraper](https://apify.com/scrapesage/whova-event-scraper)** — attendees, agendas, and sponsors from Whova apps.

### Tips

- **Paste a filtered URL** for make/model/price/sorting: set the filters on sgcarmart.com, copy the address bar into `searchUrls`, and the scraper will follow every page. Use `vehicleTypes` and `availability` for quick filter-free runs.
- **Cheap inventory diffs**: turn off `scrapeDetails` to pull just the listing fields (price, depreciation, mileage, COE, dealer name) at a fraction of the cost — perfect for daily price tracking.
- **Watch one dealer**: set `dealerCode` to a dealer's `dl=` number and schedule a daily run with `monitorMode` to catch every new car and price change.
- **Big pulls**: SGCarMart lists ~15,000+ used cars. Set `maxItems: 0` to take everything, or split by `vehicleTypes` to keep runs focused.
- **Proxies**: keep the default Singapore residential proxy — SGCarMart is Cloudflare-protected and geofenced, so datacenter or non-SG IPs get blocked.

### FAQ

**How do I scrape a specific make, model or price range?** Set the filters on sgcarmart.com, then copy the listing URL into `searchUrls`. The scraper applies them exactly as the site does and paginates through all results. For body types you can also use the `vehicleTypes` multiselect.

**Does it need the SGCarMart API or a login?** No. There's no public SGCarMart API and no login is required — this actor reads the same data the website renders, then structures and enriches it.

**Where do the dealer phone numbers come from?** From each car's public detail page, where SGCarMart shows the selling dealer's name, phone, address and profile. Turn on `scrapeDetails` to capture them.

**Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).

**How do I monitor new listings or price drops automatically?** Turn on `monitorMode` and create a [Schedule](https://docs.apify.com/platform/schedules). Each run outputs only new/changed cars, tagged with `monitorStatus` and `previousPrice`. Add a [webhook](https://docs.apify.com/platform/integrations/webhooks) or [Zapier zap](https://docs.apify.com/platform/integrations/zapier) to push them to your CRM or Slack.

**A field is empty — why?** Some dealers don't publish every field (e.g. road tax on commercial vehicles, or power on older cars). Fields are blank only when the dealer didn't publish that data — never because the scraper skipped it.

**Is scraping SGCarMart legal?** This actor collects publicly available data only. You're responsible for using the data in compliance with applicable laws (e.g. Singapore's PDPA for personal data) and SGCarMart's terms.

### Need help?

Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained.

# Actor input Schema

## `searchUrls` (type: `array`):

Paste one or more SGCarMart used-car listing or search URLs (e.g. `https://www.sgcarmart.com/used-cars/listing?vts[]=9`). Configure any filters you like on sgcarmart.com — make, model, price, depreciation, COE, sorting — then copy the URL here; the scraper paginates through all results. Leave blank to use the filters below or scrape the newest listings.

## `startUrls` (type: `array`):

Optional. Paste specific car detail-page URLs (e.g. `https://www.sgcarmart.com/used-cars/info/toyota-corolla-altis-16a-1234567/`) to scrape only those cars.

## `vehicleTypes` (type: `array`):

Restrict results to one or more body/vehicle types. Applies only when building the search from filters (i.e. when no Search URLs are pasted).

## `availability` (type: `string`):

Which listings to include when building the search from filters.

## `dealerCode` (type: `integer`):

Scrape only the inventory of a single dealer, by SGCarMart dealer code (the `dl=` value in a dealer's listing URL). Great for monitoring a specific dealer.

## `maxItems` (type: `integer`):

Maximum number of cars to scrape. Use 0 for no limit (scrape every result that matches — can be 15,000+).

## `scrapeDetails` (type: `boolean`):

Open each car's detail page to enrich it with OMV, ARF, deregistration/PARF value, road tax, COE expiry date, power, curb weight, the full photo gallery, and the dealer's phone, address and profile. Turn off for a fast, cheap listing-only run (price, depreciation, mileage, COE, make/model, dealer name).

## `monitorMode` (type: `boolean`):

Only output listings that are new or have changed (e.g. price drops) since the previous run for the same input. State persists across runs, so this pairs perfectly with Apify Schedules to track a market, model, or dealer over time without re-pulling unchanged cars. Leave off to always return every match.

## `monitorTrackPriceChanges` (type: `boolean`):

When monitor mode is on, re-emit a listing when its price changes and tag it `price_drop` / `price_increase` with the previous price. Turn off to treat only brand-new listings as changes.

## `maxConcurrency` (type: `integer`):

Maximum number of pages fetched in parallel.

## `proxyConfiguration` (type: `object`):

SGCarMart is protected by Cloudflare and is Singapore-geofenced, so Singapore residential proxies are required and used by default. Keep this setting unless you know what you're doing.

## Actor input object example

```json
{
  "vehicleTypes": [],
  "availability": "available",
  "maxItems": 100,
  "scrapeDetails": true,
  "monitorMode": false,
  "monitorTrackPriceChanges": true,
  "maxConcurrency": 8,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "SG"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped car listings in the default dataset.

# 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 = {
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/sgcarmart-used-car-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 = { "maxItems": 100 }

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/sgcarmart-used-car-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 '{
  "maxItems": 100
}' |
apify call scrapesage/sgcarmart-used-car-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapesage/sgcarmart-used-car-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "SGCarMart Used Car Scraper — Prices, COE/OMV/ARF & Dealer Leads",
        "description": "Scrape SGCarMart used-car listings: price, depreciation, COE left, OMV, ARF, PARF/dereg value, road tax, mileage, specs and the full photo gallery — plus dealer name, phone and address as leads. Filter by vehicle type or paste any search URL. Monitor mode returns only new & changed cars.",
        "version": "0.1",
        "x-build-id": "4JrbXBpCabJEKIRtP"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapesage~sgcarmart-used-car-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapesage-sgcarmart-used-car-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/scrapesage~sgcarmart-used-car-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapesage-sgcarmart-used-car-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/scrapesage~sgcarmart-used-car-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapesage-sgcarmart-used-car-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": {
                    "searchUrls": {
                        "title": "Search / listing URLs",
                        "type": "array",
                        "description": "Paste one or more SGCarMart used-car listing or search URLs (e.g. `https://www.sgcarmart.com/used-cars/listing?vts[]=9`). Configure any filters you like on sgcarmart.com — make, model, price, depreciation, COE, sorting — then copy the URL here; the scraper paginates through all results. Leave blank to use the filters below or scrape the newest listings.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "startUrls": {
                        "title": "Individual car URLs",
                        "type": "array",
                        "description": "Optional. Paste specific car detail-page URLs (e.g. `https://www.sgcarmart.com/used-cars/info/toyota-corolla-altis-16a-1234567/`) to scrape only those cars.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "vehicleTypes": {
                        "title": "Vehicle types",
                        "type": "array",
                        "description": "Restrict results to one or more body/vehicle types. Applies only when building the search from filters (i.e. when no Search URLs are pasted).",
                        "items": {
                            "type": "string",
                            "enum": [
                                "2",
                                "12",
                                "13",
                                "9",
                                "10",
                                "11",
                                "8",
                                "7",
                                "6",
                                "16",
                                "15",
                                "1",
                                "4",
                                "5",
                                "14",
                                "3"
                            ],
                            "enumTitles": [
                                "All Passenger Cars",
                                "Luxury Sedan",
                                "Mid-Sized Sedan",
                                "SUV",
                                "MPV",
                                "Hatchback",
                                "Sports",
                                "Stationwagon",
                                "Hybrid Cars",
                                "Electric Cars",
                                "Diesel Cars",
                                "All Commercial Vehicles",
                                "Van",
                                "Truck",
                                "Bus/Mini Bus",
                                "Others"
                            ]
                        },
                        "default": []
                    },
                    "availability": {
                        "title": "Availability",
                        "enum": [
                            "available",
                            "sold",
                            "all"
                        ],
                        "type": "string",
                        "description": "Which listings to include when building the search from filters.",
                        "default": "available"
                    },
                    "dealerCode": {
                        "title": "Dealer code (optional)",
                        "type": "integer",
                        "description": "Scrape only the inventory of a single dealer, by SGCarMart dealer code (the `dl=` value in a dealer's listing URL). Great for monitoring a specific dealer."
                    },
                    "maxItems": {
                        "title": "Max cars",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of cars to scrape. Use 0 for no limit (scrape every result that matches — can be 15,000+).",
                        "default": 100
                    },
                    "scrapeDetails": {
                        "title": "Scrape full detail pages",
                        "type": "boolean",
                        "description": "Open each car's detail page to enrich it with OMV, ARF, deregistration/PARF value, road tax, COE expiry date, power, curb weight, the full photo gallery, and the dealer's phone, address and profile. Turn off for a fast, cheap listing-only run (price, depreciation, mileage, COE, make/model, dealer name).",
                        "default": true
                    },
                    "monitorMode": {
                        "title": "Monitor mode (only new & changed)",
                        "type": "boolean",
                        "description": "Only output listings that are new or have changed (e.g. price drops) since the previous run for the same input. State persists across runs, so this pairs perfectly with Apify Schedules to track a market, model, or dealer over time without re-pulling unchanged cars. Leave off to always return every match.",
                        "default": false
                    },
                    "monitorTrackPriceChanges": {
                        "title": "Flag price changes",
                        "type": "boolean",
                        "description": "When monitor mode is on, re-emit a listing when its price changes and tag it `price_drop` / `price_increase` with the previous price. Turn off to treat only brand-new listings as changes.",
                        "default": true
                    },
                    "maxConcurrency": {
                        "title": "Max concurrency",
                        "minimum": 1,
                        "maximum": 30,
                        "type": "integer",
                        "description": "Maximum number of pages fetched in parallel.",
                        "default": 8
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "SGCarMart is protected by Cloudflare and is Singapore-geofenced, so Singapore residential proxies are required and used by default. Keep this setting unless you know what you're doing.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "SG"
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
