# Autochek Cars Search Scraper (`stealth_mode/autochek-cars-search-scraper`) Actor Scrape structured car listing data from Autochek.africa — including price, mileage, condition, financing, and 25+ fields per vehicle. Perfect for dealers, analysts, and automotive researchers tracking African used car markets. - **URL**: https://apify.com/stealth\_mode/autochek-cars-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Autochek.africa Car Search Scraper: Extract Used Car Listings in Africa --- ### What Is Autochek.africa? Autochek.africa is one of Africa's leading automotive marketplaces, operating across multiple countries including Nigeria, Ghana, Kenya, Uganda, and more. The platform lists thousands of inspected, graded used vehicles available for purchase — often with financing options and warranty coverage. For automotive dealers, market researchers, or price comparison platforms, manually collecting this data is impractical at scale. The **Autochek.africa Car Search Scraper** solves this by automatically extracting structured vehicle listings from search result pages, delivering clean, ready-to-analyze records across 25+ data fields per car. --- ### Overview This scraper targets Autochek.africa's car search and listing pages, collecting rich vehicle metadata from each result. It is built for: - **Auto dealers** monitoring competitor pricing and inventory - **Market analysts** studying used car trends across African markets - **Fintech platforms** assessing vehicle loan values and installment data - **Aggregator sites** feeding multi-source automotive inventory - **Researchers** tracking vehicle supply, condition grades, and demand signals Key capabilities include configurable result limits per URL, resilient error handling for failed pages, and support for paginated search URLs — making large-scale collection straightforward. --- ### Input Format The scraper accepts a JSON configuration object with the following fields: ```json { "urls": [ "https://autochek.africa/ng/cars-for-sale?page_number=2" ], "ignore_url_failures": true, "max_items_per_url": 50 } ```` #### Field Descriptions | Field | Type | Description | |---|---|---| | `urls` | `array` | One or more Autochek.africa car search/listing page URLs to scrape. Supports paginated URLs (e.g., `?page_number=3`). Add URLs one by one or paste a prepared list in bulk. | | `ignore_url_failures` | `boolean` | If `true`, the scraper continues running even when individual URLs fail — recommended for bulk runs. Default: `true`. | | `max_items_per_url` | `integer` | Maximum number of car listings to collect per URL. Adjust based on how many results per page you need. Default: `20`. | #### Input Tips - Use paginated search URLs to scrape across multiple result pages (e.g., change `page_number=1`, `page_number=2`, etc.). - Filter URLs by country, body type, or price range using Autochek's search filters before copying the URL. - Set `ignore_url_failures: true` for uninterrupted bulk runs across many pages. **Example multi-page input:** ```json { "urls": [ "https://autochek.africa/ng/cars-for-sale?page_number=1", "https://autochek.africa/ng/cars-for-sale?page_number=2", "https://autochek.africa/ng/cars-for-sale?page_number=3" ], "ignore_url_failures": true, "max_items_per_url": 50 } ``` *** ### Output Format #### Sample Output Record ```json { "medias": [ { "id": 5752668, "name": "back", "url": "https://media.autochek.africa/file/w_695,q_100/lvDMzMqX.webp", "car_id": "36PMrzdzG", "created_at": "2026-05-12T10:51:54.988Z", "type": "image/webp" }, { "id": 5752670, "name": "interiorFront", "url": "https://media.autochek.africa/file/w_732,q_100/7Nw27T7b.webp", "car_id": "36PMrzdzG", "created_at": "2026-05-12T10:51:55.015Z", "type": "image/webp" }, { "id": 5752672, "name": "interiorBack", "url": "https://media.autochek.africa/file/w_732,q_100/rk9rQgxz.webp", "car_id": "36PMrzdzG", "created_at": "2026-05-12T10:51:55.032Z", "type": "image/webp" }, { "id": 5752664, "name": "leftFront", "url": "https://media.autochek.africa/file/w_695,q_100/kvX5z1LT.webp", "car_id": "36PMrzdzG", "created_at": "2026-05-12T10:51:54.987Z", "type": "image/webp" }, { "id": 5752665, "name": "rightFront", "url": "https://media.autochek.africa/file/w_695,q_100/uB9jn098.webp", "car_id": "36PMrzdzG", "created_at": "2026-05-12T10:51:54.987Z", "type": "image/webp" }, { "id": 5752667, "name": "leftBack", "url": "https://media.autochek.africa/file/w_732,q_100/X5ktLuya.webp", "car_id": "36PMrzdzG", "created_at": "2026-05-12T10:51:54.988Z", "type": "image/webp" }, { "id": 5752666, "name": "front", "url": "https://media.autochek.africa/file/w_695,q_100/8MHTp0Bk.webp", "car_id": "36PMrzdzG", "created_at": "2026-05-12T10:51:54.987Z", "type": "image/webp" }, { "id": 5752671, "name": "rightBack", "url": "https://media.autochek.africa/file/w_732,q_100/ZB6get02.webp", "car_id": "36PMrzdzG", "created_at": "2026-05-12T10:51:55.023Z", "type": "image/webp" }, { "id": 5752669, "name": "Car Image", "url": "https://media.autochek.africa/file/w_695,q_100/Rnbwi9Ge.webp", "car_id": "36PMrzdzG", "created_at": "2026-05-12T10:51:54.988Z", "type": "image/webp", "description": "thumbnail" } ], "media": [], "id": "36PMrzdzG", "title": "Toyota Highlander", "year": 2010, "city": "Apapa", "state": "Lagos", "grade_score": 3, "selling_condition": "local", "has_warranty": false, "marketplace_price": 14000000, "marketplace_old_price": 14000000, "has_financing": true, "mileage": 112299, "mileage_unit": "miles", "installment": 563230, "loan_value": 9250934, "body_type_id": "3", "sold": false, "transmission": "automatic", "fuel_type": "petrol", "marketplace_visible_date": "2026-05-12T13:56:06.000Z", "engine_type": "6-cylinder", "inspected": null, "car_manager_id": "Abk8MpJy8", "body_type": { "id": 3, "name": "SUV" }, "trade_in": false, "auction": false } ``` Each scraped vehicle listing returns a structured record with 25+ fields: #### Media & Identification | Field | Meaning | |---|---| | `ID` | Unique internal Autochek identifier for the vehicle listing | | `Title` | Full listing title (e.g., "2018 Toyota Camry") | | `Media` | Primary image object for the vehicle | | `Medias` | Array of all listing images (gallery) | #### Vehicle Specifications | Field | Meaning | |---|---| | `Year` | Model year of the vehicle | | `Body Type` | Vehicle category (e.g., Sedan, SUV, Pickup) | | `Body Type ID` | Internal ID corresponding to the body type | | `Transmission` | Gearbox type — Automatic or Manual | | `Fuel Type` | Engine fuel type (e.g., Petrol, Diesel) | | `Engine Type` | Engine specification or displacement | | `Mileage` | Distance the vehicle has traveled | | `Mileage Unit` | Unit of mileage measurement (km or miles) | #### Condition & Quality | Field | Meaning | |---|---| | `Grade Score` | Autochek's proprietary inspection grade score — higher is better | | `Selling Condition` | Vehicle condition descriptor (e.g., Foreign Used, Locally Used) | | `Inspected` | Boolean flag — whether the car has passed Autochek's inspection process | #### Pricing & Financing | Field | Meaning | |---|---| | `Marketplace Price` | Current listed selling price | | `Marketplace Old Price` | Previous price, useful for tracking discounts | | `Has Financing` | Whether the vehicle is eligible for financing | | `Installment` | Estimated monthly installment amount | | `Loan Value` | Total loan amount available for the vehicle | | `Has Warranty` | Whether a warranty is included with the purchase | #### Location | Field | Meaning | |---|---| | `City` | City where the vehicle is located | | `State` | State or region of the listing | #### Listing Flags & Status | Field | Meaning | |---|---| | `Sold` | Whether the vehicle has already been sold | | `Marketplace Visible Date` | Date the listing became publicly visible | | `Trade In` | Whether the vehicle is eligible for a trade-in deal | | `Auction` | Whether the listing is part of an auction | | `Car Manager ID` | Internal ID of the Autochek account managing the listing | *** ### How to Use 1. **Build your search URL** — Go to Autochek.africa, apply filters (country, body type, price range, etc.), and copy the resulting search page URL. 2. **Configure the input** — Paste your URLs into the `urls` array. Add multiple paginated URLs for larger datasets. 3. **Set limits** — Adjust `max_items_per_url` based on how many listings you need per page (up to the page's natural result count). 4. **Enable fault tolerance** — Keep `ignore_url_failures: true` to prevent a single broken URL from stopping the run. 5. **Run and export** — Start the scraper, then download results as JSON, CSV, or Excel for analysis. **Common issues:** - If a URL returns no results, verify it is a *search results* page, not a single vehicle detail page. - For country-specific data, use the correct country prefix in the URL (e.g., `/ng/` for Nigeria, `/gh/` for Ghana, `/ke/` for Kenya). *** ### Use Cases & Business Value - **Price benchmarking:** Compare current market prices across vehicle makes, models, and regions in Africa - **Inventory monitoring:** Track available stock and spot when listings are marked as sold - **Financing analysis:** Aggregate installment and loan data to assess affordability trends - **Market research:** Study supply patterns by body type, fuel type, or condition grade across African cities - **Lead generation:** Identify high-grade, well-priced vehicles for resale or fleet acquisition The Autochek.africa Car Search Scraper replaces hours of manual browsing with a single automated run, producing consistent, machine-readable data that integrates directly into spreadsheets, dashboards, or custom applications. *** ### Conclusion The **Autochek.africa Car Search Scraper** is an essential tool for anyone working with African automotive market data. With 25+ structured fields per listing — spanning pricing, condition grading, financing eligibility, and location — it delivers the depth needed for serious market intelligence. Configure your search URLs, run the scraper, and turn Autochek listings into actionable data within minutes. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Cars list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://autochek.africa/ng/cars-for-sale?page_number=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://autochek.africa/ng/cars-for-sale?page_number=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/autochek-cars-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://autochek.africa/ng/cars-for-sale?page_number=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/autochek-cars-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://autochek.africa/ng/cars-for-sale?page_number=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/autochek-cars-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/autochek-cars-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Autochek Cars Search Scraper", "description": "Scrape structured car listing data from Autochek.africa — including price, mileage, condition, financing, and 25+ fields per vehicle. Perfect for dealers, analysts, and automotive researchers tracking African used car markets.", "version": "0.0", "x-build-id": "ELMGQqg3ieUlYHaxA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~autochek-cars-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-autochek-cars-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/stealth_mode~autochek-cars-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-autochek-cars-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/stealth_mode~autochek-cars-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-autochek-cars-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the Cars list urls to scrape", "type": "array", "description": "Add the URLs of the Cars list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```