## Mobile.bg Bulgaria Car Scraper
**💰 $2.05 / 1 000 results** · pay only for results · no credit card to try
_We do the dirty work so your dataset stays clean._ 😈
Scrape used-car listings from Mobile.bg, Bulgaria's #1 car marketplace — make, model, year, price in EUR (with BGN), mileage, fuel type, gearbox, engine power, engine size, body type, color, location, seller, and photos. Export to JSON or CSV; enrich each listing from its detail page.
seller_type and location.
- **Cross-border arbitrage** — compare Bulgarian prices against other EU markets to spot import deals.
- **Depreciation modelling** — build price-vs-mileage and price-vs-age curves per model.
- **Lead generation** — surface fresh private-seller listings the moment they post.
### ⚙️ How to use it
1. Click **Try for free** at the top of the page.
2. Fill in the input form — most fields have sensible defaults.
3. Click **Start**. Output streams into the run's dataset.
4. Export from **Storage → Dataset** as JSON, CSV, or Excel — or fetch via the API.
### 📥 Input
| Field | Type | Required | Default | Notes |
|---|---|:--:|---|---|
| `searchUrl` | `string` | no | '—' | Full Mobile.bg search/results URL with filters already applied (e.g. https://www.mobile.bg/obiavi/avtomobili-dzhip |
| `maxResults` | `integer` | no | 50 | Hard cap on dataset rows. |
| `enrichDetails` | `boolean` | no | True | Fetch each listing's detail page for the full technical table, exact engine size, location, and seller type. Doubles the |
| `proxyConfiguration` | `object` | no | {'useApifyProxy': True, 'apifyProxyGroups': ['RESIDENTIAL']} | Apify Proxy configuration. **RESIDENTIAL group required** — Mobile.bg 403s datacenter/direct exits. Run fails fast if unavailable. |
#### Example input
```json
{
"maxResults": 5,
"enrichDetails": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
````
### 📤 Output
Every row is one dataset item.
| Field | Type | Notes |
|---|---|---|
| `listing_id` | `string` | Mobile.bg listing ID. |
| `listing_url` | `string` | Absolute URL to the listing detail page. |
| `title` | `string` | Listing title (make + model). |
| `make` | `['string', 'null']` | Car make (e.g. Audi). |
| `model` | `['string', 'null']` | Car model (e.g. A3). |
| `year` | `['integer', 'null']` | Manufacture year. |
| `price` | `['integer', 'null']` | Asking price as an integer, in EUR. |
| `currency` | `['string', 'null']` | ISO-4217 currency code — always EUR. |
| `price_bgn` | `['integer', 'null']` | Asking price in Bulgarian lev (BGN), if shown. |
| `mileage_km` | `['integer', 'null']` | Odometer reading in kilometres. |
| `fuel_type` | `['string', 'null']` | Fuel type (Дизелов / Бензинов / Електрически / ...). |
| `transmission` | `['string', 'null']` | Gearbox (Ръчна / Автоматична). |
| `engine_power_hp` | `['integer', 'null']` | Engine power in metric horsepower (к.с.). |
| `engine_size_cc` | `['integer', 'null']` | Engine displacement in cubic centimetres. |
| `body_type` | `['string', 'null']` | Body type (Хечбек / Седан / Комби / ...). |
| `color` | `['string', 'null']` | Exterior color. |
| `first_registration` | `['string', 'null']` | Production / first-registration date (e.g. 'октомври 2010'). |
| `location` | `['string', 'null']` | Seller location (city). Enrichment-only. |
| `region` | `['string', 'null']` | Region. Enrichment-only. |
| `seller_type` | `['string', 'null']` | Seller type — dealer or private. Enrichment-only. |
| `seller_name` | `['string', 'null']` | Seller display name. Enrichment-only. |
| `photo_urls` | `array` | List of listing photo URLs. |
| `description` | `['string', 'null']` | Seller's free-text description. |
| `posted_date` | `['string', 'null']` | Relative posting marker from the listing card (e.g. 'НОВА ОБЯВА'). |
| `scraped_at` | `string` | ISO-8601 UTC timestamp when this row was recorded. |
#### Example output
```json
{
"listing_id": "11772628462288076",
"listing_url": "https://www.mobile.bg/obiava-11772628462288076-audi-a3-s-line-s3",
"title": "Audi A3 S-line S3",
"make": "Audi",
"model": "A3",
"year": 2010,
"price": 7600,
"currency": "EUR",
"price_bgn": 14864,
"mileage_km": 255000,
"fuel_type": "\u0414\u0438\u0437\u0435\u043b\u043e\u0432",
"transmission": "\u0420\u044a\u0447\u043d\u0430",
"engine_power_hp": 140,
"engine_size_cc": 2000,
"body_type": "\u0425\u0435\u0447\u0431\u0435\u043a",
"color": "\u0411\u044f\u043b",
"first_registration": "\u043e\u043a\u0442\u043e\u043c\u0432\u0440\u0438 2010",
"location": "\u0433\u0440. \u0412\u0430\u0440\u043d\u0430",
"region": null,
"seller_type": "private",
"seller_name": null,
"photo_urls": [
"//mobistatic1.focus.bg/mobile/photosorg/076/1/11772628462288076_t4.webp"
],
"description": "Audi A3 2.0 TDI ...",
"posted_date": "\u041d\u041e\u0412\u0410 \u041e\u0411\u042f\u0412\u0410",
"scraped_at": "2026-06-02T10:00:00+00:00"
}
```
### 💰 Pricing
Pay-Per-Event — you pay only when these events fire:
| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.05 | One-off warm-up charge per run |
| `result-row` | $0.002 | PPE event |
Example: 1 000 results at the rates above ≈ **$2.05**. No subscription, no minimum, no card to start — Apify gives every new account $5 of free credit.
### 🚧 Limitations
Mobile.bg paginates results and very deep queries can be truncated by the site. Detail enrichment doubles the request count and roughly doubles run time. Fuel-type, gearbox, body-type and color values are surfaced in the site's original Bulgarian (Cyrillic). Seller phone numbers behind the contact widget are not scraped. Location and seller type are only available with detail enrichment enabled.
**Residential proxy is required.** Mobile.bg returns 403 for datacenter and direct exits. The Actor enforces this — if the Apify Proxy RESIDENTIAL group is unavailable on your plan, the run will fail with a clear error message. Upgrade your Apify plan or contact support to enable residential proxy access.
### ❓ FAQ
**Do I need a search URL?**
No. Leave searchUrl empty and the Actor scrapes the default cars-and-jeeps feed. To target a make, model, or price band, apply the filters on mobile.bg and paste the resulting URL — the Actor scrapes exactly that result set.
**What currency are prices in?**
Euros. Mobile.bg shows the EUR price as primary (Bulgaria is adopting the euro); price is the integer EUR amount and currency is always EUR. The matching Bulgarian-lev amount is also kept in price\_bgn.
**What does detail enrichment add?**
Setting enrichDetails to true fetches each listing's detail page for the full technical table, exact engine displacement, the seller's city, and seller type. Set it to false to halve the request count — you still get make, model, year, price, mileage, fuel, gearbox, power, engine size, body type, color, and photos from the listing card.
**Is this an official Mobile.bg API?**
No. Mobile.bg offers no public API. This Actor scrapes the public website politely and decodes its windows-1251 Cyrillic encoding correctly.
**The labels are in Bulgarian — can I get English?**
We map the core spec fields to standard English column names (make, model, year, mileage\_km, fuel\_type, ...). Bulgarian category values such as Дизелов or Автоматична are preserved as-is so nothing is lost in translation.
### 💬 Your feedback
Spotted a bug, hit a weird edge case, or need a new field? Open an
issue on the Actor's **Issues** tab on Apify Console — we ship
fixes weekly and we read every report.
***
Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** 😈 — a small fleet of
opinionated public-data Actors. Honest pricing, real engineering, zero fine print.
# Actor input Schema
## `searchUrl` (type: `string`):
Full Mobile.bg search/results URL with filters already applied (e.g. https://www.mobile.bg/obiavi/avtomobili-dzhipove/bmw). Leave empty to scrape the default cars-and-jeeps feed.
## `maxResults` (type: `integer`):
Hard cap on dataset rows.
## `enrichDetails` (type: `boolean`):
Fetch each listing's detail page for the full technical table, exact engine size, location, and seller type. Doubles the request count.
## `proxyConfiguration` (type: `object`):
Apify Proxy configuration. The RESIDENTIAL group is required — Mobile.bg blocks datacenter and direct exits. The Actor will fail fast if residential proxy is unavailable.
## Actor input object example
```json
{
"maxResults": 50,
"enrichDetails": true,
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
```
# Actor output Schema
## `datasetItems` (type: `string`):
All dataset items as JSON.
## `datasetItemsCsv` (type: `string`):
Same data exported to CSV.
## `datasetView` (type: `string`):
Open the run dataset in the Console.
# 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 = {
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("devilscrapes/mobile-bg-bulgaria-cars").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 = { "proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
} }
# Run the Actor and wait for it to finish
run = client.actor("devilscrapes/mobile-bg-bulgaria-cars").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 '{
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call devilscrapes/mobile-bg-bulgaria-cars --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=devilscrapes/mobile-bg-bulgaria-cars",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Mobile.bg Bulgaria Car Scraper",
"description": "Scrape used-car listings from Mobile.bg, Bulgaria's #1 car marketplace — make, model, year, price in EUR (with BGN), mileage, fuel type, gearbox, engine power, engine size, body type, color, location, seller, and photos. Export to JSON or CSV; enrich each listing from its detail page.",
"version": "0.2",
"x-build-id": "wylOSPNNGHbSavcNv"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/devilscrapes~mobile-bg-bulgaria-cars/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-devilscrapes-mobile-bg-bulgaria-cars",
"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/devilscrapes~mobile-bg-bulgaria-cars/runs": {
"post": {
"operationId": "runs-sync-devilscrapes-mobile-bg-bulgaria-cars",
"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/devilscrapes~mobile-bg-bulgaria-cars/run-sync": {
"post": {
"operationId": "run-sync-devilscrapes-mobile-bg-bulgaria-cars",
"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": {
"searchUrl": {
"title": "Search URL",
"type": "string",
"description": "Full Mobile.bg search/results URL with filters already applied (e.g. https://www.mobile.bg/obiavi/avtomobili-dzhipove/bmw). Leave empty to scrape the default cars-and-jeeps feed."
},
"maxResults": {
"title": "Max results",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Hard cap on dataset rows.",
"default": 50
},
"enrichDetails": {
"title": "Enrich from detail page",
"type": "boolean",
"description": "Fetch each listing's detail page for the full technical table, exact engine size, location, and seller type. Doubles the request count.",
"default": true
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify Proxy configuration. The RESIDENTIAL group is required — Mobile.bg blocks datacenter and direct exits. The Actor will fail fast if residential proxy is unavailable.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```