{ "openapi": "3.0.1", "info": { "title": "Car Data Scraper: specs, performance & technical data", "description": "Extract consolidated car specs and performance for any brand or model, aggregated from four sources (auto-data, ultimatespecs, carperformancedata, zeperfs) into one deduplicated row per variant, with per-field source tracing and conflict flags. Export to JSON, CSV or Excel.", "version": "0.1", "x-build-id": "Xhp9zchKfYg36guxg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mrbridge~car-data-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mrbridge-car-data-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/mrbridge~car-data-scraper/runs": { "post": { "operationId": "runs-sync-mrbridge-car-data-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/mrbridge~car-data-scraper/run-sync": { "post": { "operationId": "run-sync-mrbridge-car-data-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": { "confirmRights": { "title": "I confirm I have the right to access these sources and use the data", "type": "boolean", "description": "Each source (auto-data.net, ultimatespecs.com, carperformancedata.com, zeperfs.com) has its own terms of use; some restrict automated access or commercial reuse. By running this Actor you confirm you have the right to access the enabled sources and to use the data for your purpose.", "default": false }, "inputMode": { "title": "Input mode", "enum": [ "brand", "models" ], "type": "string", "description": "Choose what to scrape. 'Brand' uses the Brand menu below to scrape every model of one make. 'Model names list' uses the Models field below to scrape only the specific models you list. Both fields stay visible (Apify forms cannot hide fields), but only the one matching this choice is used.", "default": "brand" }, "brand": { "title": "Brand", "enum": [ "212", "Abarth", "AC", "Acura", "Aeolus", "Aion", "Aistaland", "AITO", "Aiways", "Aixam", "Alfa Romeo", "Alpina", "Alpine", "Anfini", "Apollo", "Appollen", "Arcfox", "Aria", "Ariel", "Aro", "Artega", "Asia", "Aspark", "Aston Martin", "Astro", "Audi", "Aurus", "Austin", "Austin-Healey", "Autobianchi", "Avatr", "B.Engineering", "BAC", "BAIC", "Baltasar", "Baltijas Dzips", "Baojun", "BAW", "Bee Bee", "BelGee", "Bentley", "Bertone", "Bestune", "Bisu", "Bitter", "Bizzarrini", "Blonell", "BMW", "Bollinger", "Bordrin", "Borgward", "Brabham", "Bremach", "Brilliance", "Bristol", "Bufori", "Bugatti", "Buick", "BYD", "Cadillac", "Callaway", "Campagna", "Carbodies", "Caterham", "Cenntro", "ChangAn", "Changan Nevo", "ChangFeng", "Chery", "Chevrolet", "Chrysler", "Citroen", "Cizeta", "Corbellati", "Cupra", "Czinger", "Dacia", "Dadi", "Daewoo", "DAF", "Daihatsu", "Daimler", "Dallara", "Dallas", "Datsun", "David Brown", "DC", "De Lorean", "De Tomaso", "Deepal", "Denza", "Derways", "DeSoto", "DFSK", "Dodge", "DongFeng", "Doninvest", "Donkervoort", "Dorcen", "DR", "Drako", "DS", "e.GO", "Eadon Green", "Eagle", "EBRO", "Elaris", "Elemental", "EMC", "Engler", "Enovate", "Epicland", "EVO", "Exeed", "Fangchengbao", "Farizon", "FAW", "Felino", "Ferrari", "Fiat", "Firefly", "Fisker", "Fittipaldi", "FOMM", "Force Motors", "Ford", "Forthing", "Foton", "FSO", "Fulwin", "Fuqi", "GAZ", "Geely", "Genesis", "Geo", "Geometry", "GFG Style", "Ginetta", "Gleagle", "GMC", "Gordon Murray", "Great Wall", "Hafei", "Haima", "Haval", "Hawtai", "Hennessey", "Hindustan", "HiPhi", "Hispano Suiza", "Holden", "Honda", "Hongqi", "HSV", "HuangHai", "Hummer", "Hurtan", "Hycan", "Hyper", "Hyptec", "Hyundai", "iCAR", "iCAUR", "ICH-X", "ICKX", "IM", "IMSA", "INEOS", "Infiniti", "Innocenti", "Invicta", "Invicta Electric", "Iran Khodro", "Irmscher", "Isdera", "IsoRivolta", "Isuzu", "Itala", "Italdesign", "Iveco", "Izh", "JAC", "Jaecoo", "Jaguar", "Jeep", "Jetour", "Jetta", "Jiangling", "JMEV", "JY", "Kaiyi", "Karlmann King", "Karma", "KGM", "Kia", "Kimera", "Koenigsegg", "KTM", "Lada", "Lamborghini", "Lancia", "Land Rover", "Landwind", "LDV", "Leapmotor", "Lepas", "LEVC", "Lexus", "Li", "Ligier", "Lincoln", "Linktour", "Lister", "Livan", "Lordstown", "Lotus", "LTI", "LUAZ", "Lucid", "Luxeed", "Luxgen", "Lvchi", "Lynk & Co", "M-Hero", "Maextro", "Mahindra", "Marcos", "Maruti", "Maserati", "Maxus", "Maybach", "Mazda", "Mazzanti", "MCC", "McLaren", "Mega", "Melkus", "Mercedes-Benz", "Mercury", "Metrocab", "MG", "Micro", "Milan", "Minelli", "MINEmobility", "Mini", "Mitsubishi", "Mitsuoka", "Moke", "Monte Carlo", "Morgan", "Morris", "Moskvich", "Munro", "MW Motors", "Neta", "NIO", "Nissan", "Noble", "O.S.C.A.", "Oldsmobile", "Omoda", "Onvo", "Opel", "ORA", "Pagani", "Panoz", "Pariss", "Paykan", "Perodua", "Peugeot", "Picasso", "Pininfarina", "Plymouth", "Polaris", "Polestar", "Pontiac", "Porsche", "Praga", "Premier", "Proton", "PUCH", "Puma", "Puritalia", "Qiantu", "Qoros", "Qvale", "RAM", "Ravon", "Reliant", "Renault", "Renault Samsung", "Riddara", "Rimac", "Rinspeed", "Rivian", "Roewe", "Rolls-Royce", "Ronart", "Rover", "Rox", "RUF", "Saab", "SAIC", "Saleen", "Santana", "Saturn", "Sbarro", "SCG", "Scion", "Scout", "Seat", "SeAZ", "Seres", "ShuangHuan", "Silence", "Sin Cars", "Skoda", "Skywell", "SMA", "Smart", "Sono Motors", "Sony", "Soueast", "Spectre", "Sportequipe", "Spyker", "Spyros Panopoulos", "SsangYong", "SSC", "Stelato", "Subaru", "Suda", "Suzuki", "SWM", "TagAz", "Talbot", "Tank", "Tata", "Tatra", "Techrules", "Tenet", "Tesla", "Tianma", "Tianye", "Tiger", "Tofas", "Togg", "Tonggong", "Toyota", "Trabant", "Tramontana", "Triumph", "Trumpchi", "TVR", "UAZ", "Uniti", "Vanderhall", "Vauxhall", "Vector", "Vencer", "Venturi", "Vespa", "VinFast", "Volga", "Volkswagen", "Volvo", "Voyah", "VUHL", "VW-Porsche", "W Motors", "Wartburg", "Weltmeister", "Westfield", "WEY", "Wiesmann", "Xiaomi", "Xin Kai", "XPENG", "Yangwang", "Zacua", "Zastava", "ZAZ", "Zeekr", "Zenvo", "Zhidou", "ZIL", "Zotye", "ZX" ], "type": "string", "description": "Pick a car brand to scrape. The Actor returns all its models and engine variants, consolidated across the enabled sources. Used only when Input mode is 'Brand'; to target specific models, set Input mode to 'Model names list' and use the Models field." }, "models": { "title": "Models", "type": "array", "description": "Specific models to scrape, one entry per model, ALWAYS written as 'Brand Model' with the make included. For example write 'Audi RS3', not 'RS3' on its own: a model typed without its brand is ignored. Each entry expands to all generations and engine variants for that model. Used only when Input mode is 'Model names list'.", "items": { "type": "string" } }, "yearMin": { "title": "Year from", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Earliest production year to include (inclusive). Leave empty for no lower bound." }, "yearMax": { "title": "Year to", "minimum": 1900, "maximum": 2100, "type": "integer", "description": "Latest production year to include (inclusive). Leave empty for no upper bound." }, "excludeModels": { "title": "Exclude models", "type": "array", "description": "Blacklist filter: drop variants whose model name contains one of these strings (case-insensitive).", "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of car data records to emit. Set to 0 to disable the cap. Useful for test runs or cost control.", "default": 1000 }, "extraSources": { "title": "Extra sources", "type": "array", "description": "Optionally enable additional sources for deeper coverage. auto-data.net and carperformancedata.com are always used; tick ultimatespecs.com (fuller technical sheets) or zeperfs.com (European performance figures) here to add them. Both are off by default because they are slower or rate-limited, so a run with them enabled takes longer.", "items": { "type": "string", "enum": [ "ultimatespecs", "zeperfs" ], "enumTitles": [ "ultimatespecs.com (fuller specs, slower)", "zeperfs.com (EU performance, rate-limited)" ] } } } }, "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 } } } } } } } } } }