{ "openapi": "3.0.1", "info": { "title": "Mobile.bg Scraper - Bulgaria Used Cars & Seller Phones", "description": "Scrape Mobile.bg, Bulgaria's biggest car marketplace: make, model, year, price in EUR, km, fuel, power, gearbox, location and features, with 30+ filters and no 3,000 limit. Add Details for seller phones, VIN, price history, views, condition and all photos.", "version": "1.0", "x-build-id": "V0BLhCesgrPtpNPiM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~mobile-bg-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-mobile-bg-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/normdata~mobile-bg-scraper/runs": { "post": { "operationId": "runs-sync-normdata-mobile-bg-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/normdata~mobile-bg-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-mobile-bg-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": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many cars in total. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "makes": { "title": "Makes", "type": "array", "description": "Car makes (213 on Mobile.bg; type to search).", "items": { "type": "string", "enum": [ "ac", "aion", "aito", "aon", "abarth", "acura", "aixam", "alfa-romeo", "alpina", "alpine", "aonew", "aro", "asia", "aston-martin", "audi", "austin", "avatr", "baic", "baw", "bentu", "bmw", "byd", "bentley", "berliner", "bertone", "borgward", "brilliance", "bugatti", "buick", "cadillac", "carbodies", "changan", "cherry", "chery", "chevrolet", "chrysler", "citroen", "corvette", "cupra", "dfsk", "dongfeng", "dr-automobiles", "ds", "dacia", "daewoo", "daihatsu", "daimler", "datsun", "denza", "dkw", "dodge", "dr", "ebro", "evo", "eagle", "elaris", "exceed", "fso", "fangchengbao", "fangchengbau", "ferrari", "fiat", "fisker", "ford", "foton", "goupil", "gwm", "gaz", "geely", "genesis", "geo", "gmc", "gonow", "great-wall", "haval", "heinkel", "hillman", "honda", "hongqi", "hummer", "hyundai", "ifa", "ineos-grenadier", "infiniti", "innocenti", "isuzu", "iveco", "jac", "jas", "jaecoo", "jaguar", "jeep", "jetour", "jinpeng", "jmev", "jpx", "kgm", "ktm", "kanuni", "kia", "lada", "laforza", "lamborghini", "lancia", "land-rover", "landwind", "leapmotor", "lexus", "li-auto", "lifan", "lincoln", "lotus", "lucid-air", "lynkco", "mahindra", "maple", "maserati", "matra", "maxus", "maybach", "mazda", "mclaren", "mercedes-benz", "mercury", "mg", "microcar", "microlino", "mini", "mitsubishi", "morgan", "moskvich", "neta", "nio", "nissan", "oldsmobile", "omoda", "opel", "perodua", "peugeot", "pgo", "plymouth", "polestar", "polonez", "pontiac", "porsche", "proton", "qoros", "relive", "renault", "renault-samsung", "rieju", "rivian", "rolls-royce", "rover", "secma", "sh-auto", "sin-cars", "swm", "saab", "samand", "santana", "saturn", "scion", "seat", "seres", "shatenet", "shuanghuan", "simca", "skoda", "smart", "ssangyong", "subaru", "suzuki", "talbot", "tata", "tatra", "tavria", "tazzari", "telstar", "tempo", "terberg", "tesla", "today-sunshine", "tofas", "togg", "toyota", "trabant", "triumph", "uaz", "vromos", "vw", "vinfast", "vmoto", "volga", "volvo", "voyah", "warszawa", "wartburg", "wey", "wiesmann", "xiaomi", "xinkai", "xinshun", "xpeng", "yogomo", "zastava", "zaz", "zeekr", "e-go", "drugi", "pobeda", "sofiya", "chayka" ], "enumTitles": [ "AC", "AION", "AITO", "AON", "Abarth", "Acura", "Aixam", "Alfa Romeo", "Alpina", "Alpine", "Aonew", "Aro", "Asia", "Aston Martin", "Audi", "Austin", "Avatr", "BAIC", "BAW", "BENTU", "BMW", "BYD", "Bentley", "Berliner", "Bertone", "Borgward", "Brilliance", "Bugatti", "Buick", "Cadillac", "Carbodies", "Changan", "Cherry", "Chery", "Chevrolet", "Chrysler", "Citroen", "Corvette", "Cupra", "DFSK", "DONGFENG", "DR Automobiles", "DS", "Dacia", "Daewoo", "Daihatsu", "Daimler", "Datsun", "Denza", "Dkw", "Dodge", "Dr", "EBRO", "EVO", "Eagle", "Elaris", "Exceed", "FSO", "FangChengBao", "FangChengBau", "Ferrari", "Fiat", "Fisker", "Ford", "Foton", "GOUPIL", "GWM", "Gaz", "Geely", "Genesis", "Geo", "Gmc", "Gonow", "Great Wall", "Haval", "Heinkel", "Hillman", "Honda", "HongQi", "Hummer", "Hyundai", "Ifa", "Ineos Grenadier", "Infiniti", "Innocenti", "Isuzu", "Iveco", "JAC", "JAS", "Jaecoo", "Jaguar", "Jeep", "Jetour", "Jinpeng", "Jmev", "Jpx", "KGM", "KTM", "Kanuni", "Kia", "Lada", "Laforza", "Lamborghini", "Lancia", "Land Rover", "Landwind", "Leapmotor", "Lexus", "Li Auto", "Lifan", "Lincoln", "Lotus", "Lucid Air", "LynkCo", "Mahindra", "Maple", "Maserati", "Matra", "Maxus", "Maybach", "Mazda", "McLaren", "Mercedes-Benz", "Mercury", "Mg", "Microcar", "Microlino", "Mini", "Mitsubishi", "Morgan", "Moskvich", "NETA", "NIO", "Nissan", "Oldsmobile", "Omoda", "Opel", "Perodua", "Peugeot", "Pgo", "Plymouth", "Polestar", "Polonez", "Pontiac", "Porsche", "Proton", "Qoros", "Relive", "Renault", "Renault Samsung", "Rieju", "Rivian", "Rolls-Royce", "Rover", "SECMA", "SH auto", "SIN CARS", "SWM", "Saab", "Samand", "Santana", "Saturn", "Scion", "Seat", "Seres", "Shatenet", "Shuanghuan", "Simca", "Skoda", "Smart", "SsangYong", "Subaru", "Suzuki", "Talbot", "Tata", "Tatra", "Tavria", "Tazzari", "TelStar", "Tempo", "Terberg", "Tesla", "Today Sunshine", "Tofas", "Togg", "Toyota", "Trabant", "Triumph", "Uaz", "VROMOS", "VW", "VinFast", "Vmoto", "Volga", "Volvo", "Voyah", "Warszawa", "Wartburg", "Wey", "Wiesmann", "Xiaomi", "Xinkai", "Xinshun", "Xpeng", "Yogomo", "Zastava", "Zaz", "Zeekr", "e.GO", "Други", "Победа", "София", "Чайка" ] } }, "models": { "title": "Models", "type": "array", "description": "Make and model, like BMW 320, Volkswagen Golf, Mercedes-Benz E 220 or Toyota RAV4.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Bulgarian province where the car is, or Abroad (cars for sale outside Bulgaria).", "items": { "type": "string", "enum": [ "Blagoevgrad", "Burgas", "Dobrich", "Dupnitsa", "Gabrovo", "Haskovo", "Kardzhali", "Kyustendil", "Lovech", "Montana", "Pazardzhik", "Pernik", "Pleven", "Plovdiv", "Razgrad", "Ruse", "Shumen", "Silistra", "Sliven", "Smolyan", "Sofia", "Stara Zagora", "Targovishte", "Varna", "Veliko Tarnovo", "Vidin", "Vratsa", "Yambol", "Abroad" ], "enumTitles": [ "Blagoevgrad", "Burgas", "Dobrich", "Dupnitsa", "Gabrovo", "Haskovo", "Kardzhali", "Kyustendil", "Lovech", "Montana", "Pazardzhik", "Pernik", "Pleven", "Plovdiv", "Razgrad", "Ruse", "Shumen", "Silistra", "Sliven", "Smolyan", "Sofia", "Stara Zagora", "Targovishte", "Varna", "Veliko Tarnovo", "Vidin", "Vratsa", "Yambol", "Abroad (outside Bulgaria)" ] } }, "cities": { "title": "Towns", "type": "array", "description": "Town or village in Bulgaria, like Sofia, Plovdiv, Varna or Burgas (Latin or Cyrillic). Pick a region too when the name exists in more than one.", "items": { "type": "string" } }, "radiusKm": { "title": "Radius around the towns", "enum": [ "5", "10", "20", "30", "50", "100" ], "type": "string", "description": "Also include cars this far from the towns above." }, "condition": { "title": "Condition", "type": "array", "description": "Leave empty for what the site shows by default: used, new and damaged cars.", "items": { "type": "string", "enum": [ "used", "new", "damaged", "parts" ], "enumTitles": [ "Used", "New", "Damaged / crashed", "For parts" ] } }, "fuel": { "title": "Fuel", "enum": [ "Petrol", "Diesel", "Electric", "Hybrid", "Plug-in hybrid", "LPG", "Hydrogen" ], "type": "string", "description": "Engine type." }, "gearbox": { "title": "Gearbox", "enum": [ "Manual", "Automatic", "Semi-automatic" ], "type": "string", "description": "Manual, automatic or semi-automatic." }, "bodyType": { "title": "Body type", "enum": [ "Van", "SUV", "Convertible", "Estate", "Coupe", "Minivan", "Pickup", "Sedan", "Stretch limousine", "Hatchback" ], "type": "string", "description": "Body style." }, "color": { "title": "Color", "enum": [ "Ash grey", "Banana yellow", "Beata (light blue)", "Beige", "Black", "Blue", "Brick red", "Bronze", "Brown", "Burgundy", "Chameleon", "Cherry red", "Cream", "Dark blue", "Dark blue metallic", "Dark green", "Dark grey", "Dark red", "Gold", "Graphite", "Green", "Grey", "Ivory", "Light blue", "Light grey", "Metallic", "Ochre", "Orange", "Pearl", "Pink", "Purple", "Red", "Reseda green", "Sahara", "Sand", "Silver", "Tobacco", "Violet", "White", "Wine red", "Yellow" ], "type": "string", "description": "Exterior color." }, "minPrice": { "title": "Minimum price (EUR)", "minimum": 0, "type": "integer", "description": "Only cars from this price, in euros. The site compares prices with VAT included." }, "maxPrice": { "title": "Maximum price (EUR)", "minimum": 0, "type": "integer", "description": "Only cars up to this price, in euros. The site compares prices with VAT included." }, "minYear": { "title": "Year from", "minimum": 1930, "type": "integer", "description": "Only cars made in this year or later." }, "maxYear": { "title": "Year to", "minimum": 1930, "type": "integer", "description": "Only cars made in this year or earlier." }, "maxMileage": { "title": "Maximum km", "minimum": 0, "type": "integer", "description": "Only cars with at most this many kilometers." }, "minPowerHp": { "title": "Minimum power (hp)", "minimum": 0, "type": "integer", "description": "Only cars with at least this much horsepower." }, "maxPowerHp": { "title": "Maximum power (hp)", "minimum": 0, "type": "integer", "description": "Only cars with at most this much horsepower." }, "minEngineCc": { "title": "Minimum engine size (cc)", "minimum": 0, "type": "integer", "description": "Only cars with at least this displacement in cm³." }, "maxEngineCc": { "title": "Maximum engine size (cc)", "minimum": 0, "type": "integer", "description": "Only cars with at most this displacement in cm³." }, "euroStandard": { "title": "Emission standard", "enum": [ "1", "2", "3", "4", "5", "6" ], "type": "string", "description": "Only cars with this Euro standard or better." }, "features": { "title": "Features", "type": "array", "description": "Only cars that have all of these (96 features, like Navigation, Leather interior, 4x4, Panoramic roof, Service book).", "items": { "type": "string", "enum": [ "GPS tracking system", "Adaptive headlights", "ABS", "Rear airbags", "Front airbags", "Side airbags", "Electronic brake distribution (EBD)", "Electronic stability program (ESP)", "Tyre pressure monitoring", "Parking sensors", "ISOFIX", "Dynamic stability control", "Traction control", "Distance control", "Hill descent control", "360 camera / rear camera", "Apple CarPlay / Android Auto", "Auto start-stop", "Bluetooth / hands-free", "DVD, TV", "Head-up display", "Steptronic, Tiptronic", "USB, audio/video, AUX inputs", "Automatic tailgate", "Adaptive air suspension", "Keyless start", "Differential lock", "Trip computer", "High / low gears", "Ventilated seats", "Light sensor", "Electric mirrors", "Electric windows", "Electric seat adjustment", "Electric power steering", "Air conditioning", "Climate control", "Multifunction steering wheel", "Navigation", "Heated steering wheel", "Heater", "Heated windscreen", "Heated seats", "Adjustable steering wheel", "Rain sensor", "Power steering", "Headlight washers", "Cruise control", "Heat pump", "Cooled glovebox", "4x4", "7 seats", "Buy back", "Barter", "LPG system", "Long wheelbase", "Reserved / sold", "Crashed", "Short wheelbase", "Leasing", "CNG (methane) system", "For parts", "Fully serviced", "Newly imported", "Registered", "Service book", "Tuning", "2/3 doors", "4/5 doors", "LED headlights", "Xenon headlights", "Alloy wheels", "Metallic paint", "Panoramic roof", "Roof rails", "Spoilers", "Tow bar", "Halogen headlights", "Sunroof", "Off-road package", "Alarm", "Armoured", "Comprehensive insurance (casco)", "Winch", "Central locking", "Velour interior", "Right-hand drive", "Leather interior", "Light interior", "Taxi", "For disabled people", "Hearse", "Ambulance", "Driving school", "Refrigerated", "N1 homologation" ], "enumTitles": [ "GPS tracking system (Safety)", "Adaptive headlights (Safety)", "ABS (Safety)", "Rear airbags (Safety)", "Front airbags (Safety)", "Side airbags (Safety)", "Electronic brake distribution (EBD) (Safety)", "Electronic stability program (ESP) (Safety)", "Tyre pressure monitoring (Safety)", "Parking sensors (Safety)", "ISOFIX (Safety)", "Dynamic stability control (Safety)", "Traction control (Safety)", "Distance control (Safety)", "Hill descent control (Safety)", "360 camera / rear camera (Comfort)", "Apple CarPlay / Android Auto (Comfort)", "Auto start-stop (Comfort)", "Bluetooth / hands-free (Comfort)", "DVD, TV (Comfort)", "Head-up display (Comfort)", "Steptronic, Tiptronic (Comfort)", "USB, audio/video, AUX inputs (Comfort)", "Automatic tailgate (Comfort)", "Adaptive air suspension (Comfort)", "Keyless start (Comfort)", "Differential lock (Comfort)", "Trip computer (Comfort)", "High / low gears (Comfort)", "Ventilated seats (Comfort)", "Light sensor (Comfort)", "Electric mirrors (Comfort)", "Electric windows (Comfort)", "Electric seat adjustment (Comfort)", "Electric power steering (Comfort)", "Air conditioning (Comfort)", "Climate control (Comfort)", "Multifunction steering wheel (Comfort)", "Navigation (Comfort)", "Heated steering wheel (Comfort)", "Heater (Comfort)", "Heated windscreen (Comfort)", "Heated seats (Comfort)", "Adjustable steering wheel (Comfort)", "Rain sensor (Comfort)", "Power steering (Comfort)", "Headlight washers (Comfort)", "Cruise control (Comfort)", "Heat pump (Comfort)", "Cooled glovebox (Comfort)", "4x4 (Other)", "7 seats (Other)", "Buy back (Other)", "Barter (Other)", "LPG system (Other)", "Long wheelbase (Other)", "Reserved / sold (Other)", "Crashed (Other)", "Short wheelbase (Other)", "Leasing (Other)", "CNG (methane) system (Other)", "For parts (Other)", "Fully serviced (Other)", "Newly imported (Other)", "Registered (Other)", "Service book (Other)", "Tuning (Other)", "2/3 doors (Exterior)", "4/5 doors (Exterior)", "LED headlights (Exterior)", "Xenon headlights (Exterior)", "Alloy wheels (Exterior)", "Metallic paint (Exterior)", "Panoramic roof (Exterior)", "Roof rails (Exterior)", "Spoilers (Exterior)", "Tow bar (Exterior)", "Halogen headlights (Exterior)", "Sunroof (Exterior)", "Off-road package (Protection)", "Alarm (Protection)", "Armoured (Protection)", "Comprehensive insurance (casco) (Protection)", "Winch (Protection)", "Central locking (Protection)", "Velour interior (Interior)", "Right-hand drive (Interior)", "Leather interior (Interior)", "Light interior (Interior)", "Taxi (Special)", "For disabled people (Special)", "Hearse (Special)", "Ambulance (Special)", "Driving school (Special)", "Refrigerated (Special)", "N1 homologation (Special)" ] } }, "sellerType": { "title": "Seller", "enum": [ "all", "private", "dealer" ], "type": "string", "description": "Private sellers or dealers only." }, "withPhotosOnly": { "title": "With photos only", "type": "boolean", "description": "Only ads with photos." }, "withVideoOnly": { "title": "With video only", "type": "boolean", "description": "Only ads with a video." }, "withVinOnly": { "title": "With VIN only", "type": "boolean", "description": "Only ads where the seller gave the VIN." }, "vatItemizedOnly": { "title": "VAT itemized only", "type": "boolean", "description": "Only cars sold with VAT shown separately (useful for companies)." }, "sort": { "title": "Sort", "enum": [ "default", "price", "productionDate", "mileage", "newest", "newestLast2Days" ], "type": "string", "description": "Order of the results (the site's own sorting). Split searches are saved by make, model, year and price instead." }, "includeDetails": { "title": "Details", "type": "boolean", "description": "Opens each car's own page for the seller's phone numbers, VIN, condition, price history (first price and every change), views, last edit time, exact location, dealer address and member-since year, features by group, WLTP range for electric cars and all photos." }, "onlyNew": { "title": "Only new cars", "type": "boolean", "description": "Skip cars saved by earlier runs with the same monitor name." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share their history. Use a different name for each schedule." }, "startUrls": { "title": "Links", "type": "array", "description": "Mobile.bg car search pages with any filters set on the site (mobile.bg/obiavi/avtomobili-dzhipove/bmw/320/oblast-sofiya) or car pages (mobile.bg/obiava-11788890948912064-bmw-320-d). Filters are ignored with links.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }