Mercedes Benz APImercedes-benz.com ↗
Search for brand-new Mercedes-Benz, Mercedes-AMG, and Mercedes-Maybach vehicles available across official dealership stock in Germany, Italy, Czech Republic, Slovakia, Romania, and Poland, filtering by model class, fuel type, and availability. Find your perfect luxury car by browsing real-time inventory from the Mercedes-Benz online store.
curl -X GET 'https://api.parse.bot/scraper/2fe3343d-5d8b-4d1e-b2cd-12487056e18e/search_new_vehicles?sort=name-asc&limit=2&country=CZ' \ -H 'X-API-Key: $PARSE_API_KEY'
Searches the official Mercedes-Benz online store's new-vehicle stock for one country and returns one record per physical vehicle (vehicle code, model, brand incl. AMG/Maybach variants, motorization, fuel, power, colour, upholstery, stock status, estimated arrival date, local-currency gross/net price and monthly rate, selling dealer, highlights, WLTP emissions, image and detail-page URL). Only brand-new vehicles are indexed by this store (no used, certified pre-owned or demonstrator cars). By default the search is restricted to the S-Class, GLS and G-Class model families with petrol engines and to vehicles physically in stock (stock_status AVAILABLE); set in_stock_only=false to also see vehicles still in the pipeline (IN_PIPELINE). Maybach and AMG derivatives are indexed under their base model class (e.g. Mercedes-Maybach GLS 600 under GLS, Mercedes-AMG GLS 63 under GLS) and can be isolated with the brands filter. Results are paginated: page (1-based, default 1) and limit (default 20, max 50) control the window; total_results/total_pages/has_more come from the store. One call performs one upstream search request. An empty vehicles array with total_results 0 is a valid answer meaning the market currently has no matching stock (observed for Italy with the default filters). Spain is not offered: the Spanish Mercedes-Benz site has no per-vehicle new-car stock listing (only a dealer locator).
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based result page. |
| sort | string | Result ordering. |
| limit | integer | Vehicles per page, clamped to 50. |
| brands | string | Optional comma-separated brand filter exactly as shown in the store: Mercedes-Benz, Mercedes-AMG, Mercedes-Maybach. Omitted = all brands. |
| models | string | Comma-separated model class codes as used by the store's model filter, e.g. S,GLS,G (S = S-Class, GLS, G = G-Class; other confirmed codes include GLE, GLC, E, C, CLA, GLA, GLB, AMGGT). The newest-generation variant code (<CODE>_NEW) is included automatically. Unknown codes are rejected by the store. |
| countryrequired | string | Market whose store stock is searched (ISO 3166-1 alpha-2). Prices and labels are returned in that market's currency and language. |
| fuel_types | string | Comma-separated fuel type codes from the store's fuel filter. Accepted codes: PETROL, DIESEL, ELECTRIC, GAS, PETROL_ELECTRIC_PLUGIN_HYBRID, DIESEL_ELECTRIC_PLUGIN_HYBRID, PERFORMANCE_PETROL_ELECTRIC_PLUGIN_HYBRID. |
| in_stock_only | boolean | true returns only vehicles physically available (stock_status AVAILABLE); false also includes vehicles in the delivery pipeline. |
{
"type": "object",
"fields": {
"page": "1-based page returned",
"limit": "page size applied",
"country": "market searched",
"filters": "echo of the applied filters (models, fuel_types, brands, in_stock_only, sort)",
"has_more": "true when a later page exists",
"vehicles": "array of vehicle records: vehicle_code (store id, also the detail_url suffix), vin, name, brand, model_class, model_class_label, motorization, body_type, body_type_label, model_year, type_class, fuel_type, fuel_type_label, power_label, power_kw, power_hp, transmission, color, color_group, upholstery, stock_status (AVAILABLE|IN_PIPELINE), stock_category, estimated_arrival_date, production_date, price {currency, gross, net, monthly_rate} or null, dealer_id, dealer_name, dealer_address, highlights[], lines[], packages[], campaigns[], emissions[] {id,label,value,unit,display_value}, emission_test_procedure, image_url, detail_url",
"total_pages": "total pages at this limit",
"total_results": "total matching vehicles reported by the store",
"price_missing_count": "number of vehicles on this page for which the store published no price"
},
"sample": {
"data": {
"page": 1,
"limit": 3,
"country": "CZ",
"filters": {
"sort": "price-asc",
"brands": [],
"models": [
"S",
"GLS",
"G"
],
"fuel_types": [
"PETROL"
],
"in_stock_only": true
},
"has_more": true,
"vehicles": [
{
"vin": null,
"name": "S 500 4MATIC L",
"brand": "Mercedes-Benz",
"color": "Metalická modrá nautic",
"lines": [
"AMG line"
],
"price": {
"net": 3678400,
"gross": 4325302.91,
"currency": "CZK",
"monthly_rate": 32619.3
},
"packages": [
"Sada Premium"
],
"power_hp": 449,
"power_kw": 330,
"body_type": "LONG_SEDAN",
"campaigns": [],
"dealer_id": "GS0049862",
"emissions": [
{
"id": "85W",
"unit": "g/km",
"label": "Celkové emise CO₂ (kombinovaný provoz)",
"value": "199",
"display_value": "199 g/km"
},
{
"id": "90W",
"unit": "l/100km",
"label": "Celková spotřeba (kombinovaný provoz)",
"value": "8.7",
"display_value": "8,7 l/100km"
}
],
"fuel_type": "PETROL",
"image_url": "https://media.oneweb.mercedes-benz.com/images/dynamic/europe/CZ/223164/807/iris.png?q=...",
"detail_url": "https://www.mercedes-benz.cz/passengercars/buy/new-car/product.html/MBZ154M8A",
"highlights": [
"Natáčecí zadní náprava s úhlem natočení 4,5⁰",
"Nezávislé topení/větrání",
"Vyhřívaný multifunkční volant"
],
"model_year": 2027,
"type_class": "V223",
"upholstery": "Kůže nappa hnědá beech/černá",
"color_group": "Modrá",
"dealer_name": "SAGA PRAHA s.r.o.",
"model_class": "S",
"power_label": "330 kW + 17 kW (449 k + 23 k)",
"motorization": "S 500 4MATIC",
"stock_status": "AVAILABLE",
"transmission": "AUTOMATIC",
"vehicle_code": "MBZ154M8A",
"dealer_address": "Daimlerova 2296/2, 149 00 Praha - Chodov",
"stock_category": "DEALER_STOCK",
"body_type_label": "Prodloužená limuzína",
"fuel_type_label": "Benzín",
"production_date": "2026-08-05",
"model_class_label": "Třída S",
"estimated_arrival_date": "2026-08-07",
"emission_test_procedure": "WLTP"
}
],
"total_pages": 10,
"total_results": 28,
"price_missing_count": 0
},
"status": "success"
}
}About the Mercedes Benz API
The Mercedes Benz API on Parse exposes 1 endpoint for the publicly available data on mercedes-benz.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.