{ "openapi": "3.0.1", "info": { "title": "Car data scraper: specs, 0-60 times and power", "description": "Extract consolidated car specs and performance for any brand or model: power, torque, 0-60 mph, quarter mile, top speed and full technical data. Four sources (auto-data, ultimatespecs, carperformancedata, zeperfs) are merged into one deduplicated row per variant with source tracing. By MrBridge", "version": "0.1", "x-build-id": "wbXpGXamd0v7OeGhO" }, "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", "Evolute", "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", "HWA", "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", "UMO", "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": "Exact model names to exclude, case-insensitive. Enter either the model name (TT) or make and model (Audi TT). TT does not exclude TTS.", "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of car data records to emit. Useful for test runs and cost control. A run always needs at least one limit, so removing this cap through the API requires the run to have a timeout.", "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 } } } } } } } } } }