# Mashina.kg Scraper — Kyrgyzstan Cars, Prices & Specs (`logiover/mashina-kg-car-scraper`) Actor

Scrape Mashina.kg, Kyrgyzstan's biggest car marketplace, in bulk: title, price in USD, year, mileage, engine displacement, transmission, steering side, body type and location as separate sortable columns. Any search URL. No login, no API key.

- **URL**: https://apify.com/logiover/mashina-kg-car-scraper.md
- **Developed by:** [Logiover](https://apify.com/logiover) (community)
- **Categories:** E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.50 / 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/actors/running/actors-in-store.md#pay-per-event

## 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

## Mashina.kg Scraper — Kyrgyzstan Cars, Prices & Specs

Scrape **Mashina.kg**, Kyrgyzstan's largest car marketplace, in bulk — **no login, no API key, no browser**. Point the Actor at any category or result page and it walks the pages, parses every card into flat, sortable columns, and saves rows as it goes.

> **16 columns per row** · thousands of rows per run · numeric prices, not strings · JSON, CSV, Excel or API · pay only for the rows you keep.

***

### Why this Mashina.kg scraper

Mashina.kg publishes everything a buyer needs on the result page — but as prose, inside a card, behind pagination. Reading it at any useful scale by hand is not realistic, and copy-paste gives you text where you need numbers.

This Actor turns those pages into a table. **`price` is a number**, not a formatted string. Location, seller and vehicle specs are their own columns instead of one blob. That is the difference between data you can pivot on and data you have to clean first.

It is built on the same engine as the rest of this fleet, which means three things you only notice when they are missing:

- **It respects the clock.** Every run carries a time budget and saves rows continuously, so a slow page never costs you the whole run.
- **One bad page does not end the crawl.** An unreachable page is retried, then skipped and logged — not treated as the end of the listing.
- **It says what it did.** Row counts, skipped pages and stop reasons all appear in the log, so a short run is always explainable.

***

### What you get

#### Central Asian car market research

Mashina.kg is the reference car marketplace for Kyrgyzstan. `priceUsd` is numeric, `year` and `mileage` are parsed from the spec line, and `location` tells you the city — enough for a market study in a region with few structured data sources.

#### Import and steering analysis

Most cars in Kyrgyzstan are imported. `steering` tells you LHD vs RHD — a key signal for which source markets (Japan RHD vs Korea/Europe LHD) dominate in each price range.

#### Price benchmarking in USD

All prices are converted to USD by Mashina.kg itself. That gives you a stable baseline for comparison across Central Asian markets without currency conversion headaches.

#### Regional demand mapping

`location` shows the city (Bishkek, Osh, Jalal-Abad, etc.). Compare listing volume and pricing across cities to map regional demand patterns.

***

### Input

| Field | Type | What it does |
|---|---|---|
| `startUrl` | string | Any Mashina.kg category or result URL. The Actor paginates from here. |
| `maxResults` | integer | Stop after this many rows (default 200). |
| `proxyConfiguration` | object | Apify Proxy settings. The default is fine. |

> **Note:** Mashina.kg embeds every filter in the URL. Copy any search or filter result page URL and paste it as the start URL.

#### Example input

```json
{
  "startUrl": "https://www.mashina.kg/search/all/",

  "maxResults": 200,
  "proxyConfiguration": { "useApifyProxy": true }
}
```

***

### Output

One row per listing, 16 columns:

| Column | Type | Description |
|---|---|---|
| `listingId` | string | Mashina.kg listing slug with hex ID. |
| `title` | string | Car headline (make, model, generation, trim). |
| `listingUrl` | string | Canonical listing page on Mashina.kg. |
| `priceUsd` | number | Asking price in US dollars. |
| `currency` | string | Always USD. |
| `year` | number | Model year. |
| `mileage` | number | Odometer reading in kilometres. |
| `engine` | string | Engine displacement in litres (e.g. 1.6, 2.0). |
| `transmission` | string | Transmission type in Russian (автомат, механика, робот, вариатор). |
| `steering` | string | LHD (left-hand drive) or RHD (right-hand drive). |
| `bodyType` | string | Body style in Russian (седан, внедорожник, хэтчбек, etc.). |
| `location` | string | City name (Бишкек, Ош, etc.). |
| `imageUrl` | string | First listing photo. |
| `country` | string | Always Kyrgyzstan. |
| `source` | string | Always mashina\_kg. |
| `scrapedAt` | string | ISO timestamp of collection. |

#### Example row

```json
{
  "listingId": "…",
  "title": "…",
  "listingUrl": "…",
  "priceUsd": 0,
  "currency": "…",
  "year": 0,
  "mileage": 0,
  "engine": "…",
  "transmission": "…",
  "steering": "…",
  "bodyType": "…",
  "location": "…",
  "imageUrl": "…",
  "country": "…",
  "source": "…",
  "scrapedAt": "…"
}
```

Export from the Apify Console as **JSON, CSV, Excel, XML or RSS**, or pull it straight from the [Dataset API](https://docs.apify.com/api/v2#/reference/datasets/item-collection/get-items).

***

### How to use it

1. Open the Actor and paste a Mashina.kg URL into **Category or listing URL**.
2. Set **Maximum results** to how many rows you want.
3. Click **Start**. Rows appear in the dataset while the run is still going.
4. Export, or schedule the run daily and diff the results to track price moves.

You can also run it from the [Apify API](https://docs.apify.com/api/v2), the [JavaScript client](https://docs.apify.com/api/client/js/) or the [Python client](https://docs.apify.com/api/client/python/), and wire the output into Google Sheets, Zapier, Make or your own warehouse.

***

### Frequently asked questions

**Do I need a Mashina.kg account?**

No. All data comes from public search result pages — no login, no API key.

**What does `steering` mean?**

LHD = left-hand drive (steering wheel on the left, most common in Kyrgyzstan). RHD = right-hand drive (common in Japanese imports).

**Why is `engine` sometimes null?**

Electric vehicles and some listings do not display an engine displacement. The column is null in those cases.

**Are prices in the local currency?**

Prices are in USD as displayed by Mashina.kg. The site shows both KGS and USD; the Actor captures the USD value for easier comparison.

**Which cities appear in `location`?**

Bishkek, Osh, Jalal-Abad, Tokmok, Karakol and other Kyrgyz cities as published by the seller.

**Why are transmission and body type in Russian?**

Mashina.kg serves its data in Russian. автомат = automatic, механика = manual. седан = sedan, внедорожник = SUV.

**How much does it cost?**

You pay per row kept, plus Apify platform usage. A 1,000-row run is inexpensive; run it on a schedule and you have a continuous price feed for the cost of a coffee.

**Is scraping Mashina.kg legal?**

This Actor reads only publicly available pages — the same ones anyone can open in a browser — and collects no personal data beyond the seller display name that Mashina.kg itself publishes next to each listing. You are responsible for how you use the output, including compliance with Mashina.kg's terms and with data-protection law such as the GDPR. If in doubt, take legal advice.

***

### Related Actors

Browse the rest of the fleet for country marketplace, classifieds, property and company-registry scrapers covering more than eighty countries.

***

### Support

Found a broken column or a site change? Open an issue on the Actor's **Issues** tab and it will be looked at. This Actor is actively maintained — see the Changelog for its history.

***

*Mashina.kg is a trademark of its respective owner. This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Mashina.kg.*

# Actor input Schema

## `startUrl` (type: `string`):

Any Mashina.kg category or result URL. The Actor walks its pages from here. Example: https://www.mashina.kg/search/all/

## `maxResults` (type: `integer`):

Stop after this many rows. The Actor walks pages until the target is met, the listing runs out, or the run's time budget is spent.

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

Mashina.kg serves plain HTML; the default Apify Proxy is enough.

## Actor input object example

```json
{
  "startUrl": "https://www.mashina.kg/search/all/",
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

Dataset with one row per Mashina.kg listing.

# 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 = {
    "startUrl": "https://www.mashina.kg/search/all/",
    "maxResults": 200,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("logiover/mashina-kg-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 = {
    "startUrl": "https://www.mashina.kg/search/all/",
    "maxResults": 200,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("logiover/mashina-kg-car-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 '{
  "startUrl": "https://www.mashina.kg/search/all/",
  "maxResults": 200,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call logiover/mashina-kg-car-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,logiover/mashina-kg-car-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/bKzdr4nIww6nSogez/builds/eKB2qtkchc1aWgUaY/openapi.json