# Sgcarmart Used Cars Scraper (`alwaysprimedev/sgcarmart-scraper`) Actor Scrape every used-car listing on sgcarmart.com — price, specs, photos, dealer, COE — in structured JSON, CSV or Excel. - **URL**: https://apify.com/alwaysprimedev/sgcarmart-scraper.md - **Developed by:** [Always Prime](https://apify.com/alwaysprimedev) (community) - **Categories:** Developer tools, Social media, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.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. 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 Cars Scraper — Singapore's #1 Car Marketplace, in one click [![Apify](https://img.shields.io/badge/Apify-Actor-blue)](https://apify.com) [![Python](https://img.shields.io/badge/python-3.11-3776AB)](https://www.python.org) [![Output](https://img.shields.io/badge/output-JSON%20%E2%80%A2%20CSV%20%E2%80%A2%20Excel-green)]() **Get every used-car listing on [sgcarmart.com](https://www.sgcarmart.com) — price, depreciation, COE, OMV, mileage, photos, dealer info — as structured JSON, CSV or Excel. No code, no captcha, no scraping experience needed.** ⚡️ Built for Singapore's used-car market: 15,000+ live listings, fresh every run. --- ### ✨ Why this scraper - 🏎️ **Full coverage** — every car on sgcarmart, every page, every detail field - 💰 **Pricing intelligence** — Price, Depreciation, COE, OMV, ARF, Dereg Value, Road Tax — all parsed into numbers - 🔋 **EV-aware** — captures fuel type, electric drive range, kW/bhp power - 📸 **Every photo URL** — primary + gallery, ready to download - ⚡️ **Fast** — pulls ~5 listings/sec on default settings - 📦 **Drop-in formats** — JSON, CSV, Excel — straight into Sheets, Power BI, your warehouse - 🤖 **Run on a schedule** — daily inventory snapshots, weekly price moves - 🛡️ **Robust** — automatic retries, TLS-fingerprint rotation, structured logs --- ### 🚀 Quick start 1. 👉 Click **Try for free** above 2. 🎯 Pick a sort order, set a max price, or paste specific car URLs (or leave everything blank for newest cars) 3. ▶️ Hit **Start** — your run begins in seconds 4. 📥 Download as JSON, CSV or Excel from the **Storage** tab --- ### 📋 Input | Field | What it does | | --- | --- | | `maxItems` | Stop after N listings. `0` = scrape everything. | | `sortBy` | `newest`, `oldest`, `priceLowToHigh`, `priceHighToLow`, `mileageLow`, `depreciationLow` | | `minPrice` / `maxPrice` | SGD range, e.g. 30000 – 100000 | | `vehicleType` | Body types: `5` Hatchback, `7` Sedan, `9` SUV, `8` MPV, `4` Coupe, `1` Sports | | `make` / `model` | Brand and model codes (see sgcarmart's filter UI) | | `scrapeDetails` | Off = URLs only (cheap diff). On = full record. | | `since` | Skip listings registered before this date — perfect for daily refresh | | `concurrency` | 1–25. Default 5. | | `startUrls` | Advanced: paste listing URLs to scrape only those cars | --- ### 📦 Sample output ```json { "id": 1495126, "url": "https://www.sgcarmart.com/used-cars/info/byd-sealion-7-electric-1495126", "scraped_at": "2026-05-15T09:30:00Z", "car_model": "BYD Sealion 7 Electric Premium", "make": "BYD", "model": "Sealion", "year": 2025, "price_sgd": 210000, "depreciation_sgd_per_year": 22010, "coe_sgd": 117003, "installment_sgd": 1729, "road_tax_sgd_per_year": 2264, "omv_sgd": 38500, "arf_sgd": 5900, "dereg_value_sgd": 98027, "reg_date": "2025-10-10", "original_reg_date": null, "manufactured": 2025, "mileage_km": 125, "transmission": "Auto", "engine_cap_cc": null, "drive_range_km": null, "fuel_type": "Electric", "power": "230.0 kW (308 bhp)", "curb_weight_kg": 2225, "owners": 1, "vehicle_type": "SUV", "status": "Available for sale", "coe_left": "9yrs 4mths 24days COE left", "category": "PARF Car, Direct Owner", "description": "Almost brand new condition interior and exterior.", "features": null, "accessories": null, "inspection_grade": null, "dealer_code": 1000, "dealer_type": "Direct Owner", "is_direct_owner": true, "primary_image_url": "https://i.i-sgcm.com/cars_used/202604/1495126_1b.jpg", "photo_urls": [ "https://i.i-sgcm.com/cars_used/202604/1495126_1.jpg", "https://i.i-sgcm.com/cars_used/202604/1495126_1b.jpg", "https://i.i-sgcm.com/cars_used/202604/1495126_2b.jpg", "https://i.i-sgcm.com/cars_used/202604/1495126_3b.jpg" ] } ```` *** ### 💡 Use cases | Who | What for | | --- | --- | | 🏦 **Banks & insurers** | Used-car loan & insurance pricing, residual-value models | | 📊 **Auto analysts** | Market trends, depreciation curves, COE price impact | | 🏎️ **Dealers** | Competitive pricing, gap analysis, sourcing leads | | 🤖 **ML / data teams** | Train pricing models, listings classification, vision datasets | | 💼 **PropTech for autos** | Power valuation tools, dealer dashboards, price alerts | | 🛒 **Buyers & researchers** | Track price drops, monitor specific models, build watchlists | *** ### 🔥 Tips & tricks - **Daily snapshot** — schedule the actor to run every morning with `sortBy: "newest"` and `since: `. You'll only pay for fresh listings. - **Index-only diff** — flip `scrapeDetails: false` for ultra-cheap inventory refresh. Pull the IDs, then enrich only the new ones tomorrow. - **Specific cars** — paste any sgcarmart URLs into `startUrls` to skip search entirely. - **EV-only run** — set `fuel_type` filter via the site's URL parameters in `startUrls` for a clean electric-only dataset. *** ### ❓ FAQ **How fresh is the data?** Every run pulls live from sgcarmart in real time — no caching. Typical 100-listing run finishes in under a minute. **Can I scrape a specific car?** Yes — paste its URL into `startUrls`. The scraper will skip the search step entirely. **What about new cars / accessories / car loans?** This actor focuses on used cars. If you want new-car listings, drop us a note — happy to ship a sibling actor. **Is the data complete?** Every advertised field on the listing page is captured. Some fields (`engine_cap_cc`, `drive_range_km`) are intentionally `null` for vehicles where sgcarmart doesn't publish them (e.g. EVs don't have engine displacement). **Does it include seller phone numbers?** No. We deliberately exclude personal contact details to respect Singapore PDPA and user privacy. **How does pricing work?** Pay only for what you scrape — a flat per-result rate. The first run is free so you can try before you commit. *** ### 📞 Need help? Open an issue or message us on Apify — we typically reply within a few hours. Happy scraping! 🏎️💨 # Actor input Schema ## `maxItems` (type: `integer`): Stop after this many listings have been saved. Use 0 to scrape every result that matches your filters. ## `sortBy` (type: `string`): How sgcarmart should order the search results before scraping. "Newest" matches the default behaviour on the site. ## `minPrice` (type: `integer`): Only return listings priced at or above this amount in Singapore dollars. Leave blank for no lower bound. ## `maxPrice` (type: `integer`): Only return listings priced at or below this amount in Singapore dollars. Leave blank for no upper bound. ## `vehicleType` (type: `array`): Restrict results to one or more body types. Common values: 5 (Hatchback), 7 (Sedan), 9 (SUV), 8 (MPV), 4 (Coupe), 1 (Sports Car). ## `make` (type: `string`): Restrict results to one make code (e.g. "5" for Toyota). Leave blank for all makes. See sgcarmart's listing UI for the full code list. ## `model` (type: `string`): Optional model code to combine with the make filter. Leave blank to include every model from the chosen make. ## `scrapeDetails` (type: `boolean`): Turn off to only collect listing URLs and IDs (cheap inventory diff runs). Turn on for the full record with price, specs, photos, dealer info. ## `since` (type: `string`): ISO date or datetime (e.g. 2026-01-01). Listings with a registration date earlier than this will be skipped. Leave blank for no time filter. ## `concurrency` (type: `integer`): How many detail pages to fetch in parallel. Higher is faster but more aggressive; 5 is the safe default. Capped at 25. ## `startUrls` (type: `array`): Paste sgcarmart listing URLs to scrape only those specific cars and skip search. Overrides the filter fields above. ## Actor input object example ```json { "maxItems": 50, "sortBy": "newest", "minPrice": 30000, "maxPrice": 100000, "vehicleType": [ "9" ], "make": "5", "scrapeDetails": true, "since": "2026-01-01", "concurrency": 5, "startUrls": [] } ``` # Actor output Schema ## `listingsJson` (type: `string`): Full machine-readable dataset, one listing per object. ## `listingsCsv` (type: `string`): Spreadsheet-friendly CSV of all scraped listings. ## `listingsXlsx` (type: `string`): Excel-ready .xlsx export of all scraped listings. ## `consoleView` (type: `string`): Inspect, filter and export the dataset from the Apify UI. # 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 = { "maxItems": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("alwaysprimedev/sgcarmart-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 = { "maxItems": 50 } # Run the Actor and wait for it to finish run = client.actor("alwaysprimedev/sgcarmart-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": 50 }' | apify call alwaysprimedev/sgcarmart-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=alwaysprimedev/sgcarmart-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Sgcarmart Used Cars Scraper", "description": "Scrape every used-car listing on sgcarmart.com — price, specs, photos, dealer, COE — in structured JSON, CSV or Excel.", "version": "0.1", "x-build-id": "4xqNExFeLnXNtJmDi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alwaysprimedev~sgcarmart-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alwaysprimedev-sgcarmart-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/alwaysprimedev~sgcarmart-scraper/runs": { "post": { "operationId": "runs-sync-alwaysprimedev-sgcarmart-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/alwaysprimedev~sgcarmart-scraper/run-sync": { "post": { "operationId": "run-sync-alwaysprimedev-sgcarmart-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": { "maxItems": { "title": "Max number of listings", "minimum": 0, "type": "integer", "description": "Stop after this many listings have been saved. Use 0 to scrape every result that matches your filters.", "default": 50 }, "sortBy": { "title": "Sort results by", "enum": [ "newest", "oldest", "priceLowToHigh", "priceHighToLow", "mileageLow", "depreciationLow" ], "type": "string", "description": "How sgcarmart should order the search results before scraping. \"Newest\" matches the default behaviour on the site.", "default": "newest" }, "minPrice": { "title": "Minimum price (SGD)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this amount in Singapore dollars. Leave blank for no lower bound." }, "maxPrice": { "title": "Maximum price (SGD)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this amount in Singapore dollars. Leave blank for no upper bound." }, "vehicleType": { "title": "Vehicle types", "type": "array", "description": "Restrict results to one or more body types. Common values: 5 (Hatchback), 7 (Sedan), 9 (SUV), 8 (MPV), 4 (Coupe), 1 (Sports Car).", "default": [], "items": { "type": "string" } }, "make": { "title": "Make", "type": "string", "description": "Restrict results to one make code (e.g. \"5\" for Toyota). Leave blank for all makes. See sgcarmart's listing UI for the full code list." }, "model": { "title": "Model", "type": "string", "description": "Optional model code to combine with the make filter. Leave blank to include every model from the chosen make." }, "scrapeDetails": { "title": "Scrape full listing detail", "type": "boolean", "description": "Turn off to only collect listing URLs and IDs (cheap inventory diff runs). Turn on for the full record with price, specs, photos, dealer info.", "default": true }, "since": { "title": "Only listings registered after", "type": "string", "description": "ISO date or datetime (e.g. 2026-01-01). Listings with a registration date earlier than this will be skipped. Leave blank for no time filter." }, "concurrency": { "title": "Concurrent requests", "minimum": 1, "maximum": 25, "type": "integer", "description": "How many detail pages to fetch in parallel. Higher is faster but more aggressive; 5 is the safe default. Capped at 25.", "default": 5 }, "startUrls": { "title": "Advanced: start from these URLs", "type": "array", "description": "Paste sgcarmart listing URLs to scrape only those specific cars and skip search. Overrides the filter fields above.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } } ```