{ "openapi": "3.0.1", "info": { "title": "Used Car Listings & Dealer Inventory Export", "description": "Export used car listings, dealer inventory, and historical vehicle data from 100+ car marketplaces. Filter by brand, model, price, year, mileage, country, and history.", "version": "0.0", "x-build-id": "PLyhEmHsTyjn70lTa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thescrapelab~ultimate-car-listings-scraper-100-sites/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thescrapelab-ultimate-car-listings-scraper-100-sites", "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/thescrapelab~ultimate-car-listings-scraper-100-sites/runs": { "post": { "operationId": "runs-sync-thescrapelab-ultimate-car-listings-scraper-100-sites", "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/thescrapelab~ultimate-car-listings-scraper-100-sites/run-sync": { "post": { "operationId": "run-sync-thescrapelab-ultimate-car-listings-scraper-100-sites", "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": { "countries": { "title": "Country", "type": "array", "description": "Choose one or more markets to export from. Default: South Africa.", "items": { "type": "string", "enum": [ "AR", "AT", "AU", "BE", "BH", "BR", "CA", "CH", "CI", "DK", "DE", "DO", "EC", "EG", "ES", "FI", "FR", "GB", "GH", "GT", "HN", "IN", "IE", "IT", "JP", "KE", "KW", "KZ", "LB", "LK", "MX", "NG", "NI", "NL", "NO", "NZ", "OM", "PA", "PH", "PK", "PL", "PT", "PY", "QA", "RO", "RS", "SE", "SG", "SK", "SV", "UA", "UG", "US", "UZ", "VN", "ZA" ], "enumTitles": [ "Argentina (AR)", "Austria (AT)", "Australia (AU)", "Belgium (BE)", "Bahrain (BH)", "Brazil (BR)", "Canada (CA)", "Switzerland (CH)", "Cote d'Ivoire (CI)", "Denmark (DK)", "Germany (DE)", "Dominican Republic (DO)", "Ecuador (EC)", "Egypt (EG)", "Spain (ES)", "Finland (FI)", "France (FR)", "United Kingdom (GB)", "Ghana (GH)", "Guatemala (GT)", "Honduras (HN)", "India (IN)", "Ireland (IE)", "Italy (IT)", "Japan (JP)", "Kenya (KE)", "Kuwait (KW)", "Kazakhstan (KZ)", "Lebanon (LB)", "Sri Lanka (LK)", "Mexico (MX)", "Nigeria (NG)", "Nicaragua (NI)", "Netherlands (NL)", "Norway (NO)", "New Zealand (NZ)", "Oman (OM)", "Panama (PA)", "Philippines (PH)", "Pakistan (PK)", "Poland (PL)", "Portugal (PT)", "Paraguay (PY)", "Qatar (QA)", "Romania (RO)", "Serbia (RS)", "Sweden (SE)", "Singapore (SG)", "Slovakia (SK)", "El Salvador (SV)", "Ukraine (UA)", "Uganda (UG)", "United States (US)", "Uzbekistan (UZ)", "Vietnam (VN)", "South Africa (ZA)" ] }, "default": [ "ZA" ] }, "search": { "title": "Vehicle Search", "type": "string", "description": "Optional. Search listing title, vehicle name, brand, and model. Example: Toyota Corolla.", "default": "" }, "limit": { "title": "Result Limit", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum dataset rows to export. Start with 100, then increase after checking results.", "default": 100 }, "estimateOnly": { "title": "Preview Only", "type": "boolean", "description": "Count matching rows without exporting or charging for result items. Useful before large exports.", "default": false }, "brandQuery": { "title": "Brand", "type": "string", "description": "Optional. Use when you want a dedicated brand filter instead of, or in addition to, Vehicle Search.", "default": "" }, "modelQuery": { "title": "Model", "type": "string", "description": "Optional. Use when you want a dedicated model filter. Example: Corolla.", "default": "" }, "yearMin": { "title": "Minimum Year", "minimum": 0, "type": "integer", "description": "Optional. Earliest vehicle year to include. Leave 0 to ignore.", "default": 0 }, "yearMax": { "title": "Maximum Year", "minimum": 0, "type": "integer", "description": "Optional. Latest vehicle year to include. Leave 0 to ignore.", "default": 0 }, "minPrice": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Optional. Lowest listing price in the listing currency. Leave 0 to ignore.", "default": 0 }, "maxPrice": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Optional. Highest listing price in the listing currency. Leave 0 to ignore.", "default": 0 }, "mileageMin": { "title": "Minimum Mileage", "minimum": 0, "type": "integer", "description": "Optional. Lowest mileage in kilometers. Leave 0 to ignore.", "default": 0 }, "mileageMax": { "title": "Maximum Mileage", "minimum": 0, "type": "integer", "description": "Optional. Highest mileage in kilometers. Leave 0 to ignore.", "default": 0 }, "websites": { "title": "Exact Websites", "type": "array", "description": "Advanced. Pick exact source websites only when country-wide exports are too broad.", "items": { "type": "string", "enum": [ "carscoza", "webuycars", "autotraderca", "cardekho", "pakwheels", "subitoit", "finnno", "nettiautofi", "marktplaats", "bilbasendk", "otomotopl", "autovitro", "standvirtualpt", "mercadolibrear", "mercadolibremx", "autotraderau", "picklesau", "trademenz", "autotradernz", "turnersnz", "truecarus", "carmaxus", "carpagesca", "autolistus", "carscomus", "enterprisecarsalesus", "craigslistus", "classiccarsus", "bringatrailerus", "ebaymotorsde", "ebaymotorsch", "autochekafrica", "carwalein", "carwowuk", "carwowde", "cinchuk", "carsguideau", "driveau", "gumtreeuk", "gumtreeza", "autocitygroupza", "carshopza", "carzoneie", "arnoldclarkuk", "cmhza", "johnhughesau", "kiacertifiedza", "kleinanzeigende", "motusselectza", "carfindza", "nissanusedcarsza", "justcarsau", "onlycarsau", "kijijica", "kijijiautosca", "motorsuk", "olxbr", "olxeg", "olxlbauto", "olxkzauto", "olxpk", "olxplauto", "olxptauto", "pistonheadsuk", "ikmanlk", "chototvn", "chekike", "beforwardjp", "autoriaua", "kolesakz", "carfromjapan", "goonetjp", "sbtjapan", "tcvjapan", "sgcarmartsg", "autotraderza", "carandclassicuk", "kavakmx", "olxuaauto", "olxroauto", "autochekng", "autochekke", "autochekgh", "autochekug", "autochekci", "usedcarsphil", "philkotseph", "autodealph", "carmudiph", "jijike", "jijigh", "jijiug", "jijing", "autoscout24fr", "lacentralefr", "blocketse", "olxuzauto", "mercadolibredo", "mercadolibregt", "mercadolibrehn", "mercadolibreni", "mercadolibrepa", "mercadolibreec", "mercadolibrepy", "mercadolibresv", "dubizzleom", "dubizzlekw", "dubizzleqa", "dubizzlebh", "theaausedcarsuk", "autobazareu", "autoherode", "autoherose", "autoheroes", "autoheroit", "autoherofr", "autoheronl", "autoheroat", "autoheropl", "autoherobe", "polovniautomobilirs" ], "enumTitles": [ "Cars.co.za (ZA)", "WeBuyCars (ZA)", "AutoTrader Canada (CA)", "CarDekho (IN)", "PakWheels (PK)", "Subito Italy (IT)", "FINN (NO)", "Nettiauto Finland (FI)", "Marktplaats (NL)", "Bilbasen Denmark (DK)", "OTOMOTO (PL)", "Autovit (RO)", "Standvirtual (PT)", "Mercado Libre Argentina (AR)", "Mercado Libre Mexico (MX)", "AutoTrader Australia (AU)", "Pickles (AU)", "Trade Me (NZ)", "AutoTrader New Zealand (NZ)", "Turners (NZ)", "TrueCar (US)", "CarMax (US)", "Carpages.ca (CA)", "Autolist (US)", "Cars.com (US)", "Enterprise Car Sales (US)", "Craigslist (US)", "ClassicCars (US)", "Bring a Trailer (US)", "eBay Motors Germany (DE)", "eBay Motors Switzerland (CH)", "AutoChek Africa Global (NG feed)", "CarWale (IN)", "Carwow UK (GB)", "Carwow Germany (DE)", "cinch UK (GB)", "CarsGuide Australia (AU)", "Drive (AU)", "Gumtree UK (GB)", "Gumtree South Africa (ZA)", "AutoCity Group (ZA)", "Carshop (ZA)", "Carzone Ireland (IE)", "Arnold Clark (GB)", "CMH Used Cars (ZA)", "John Hughes Used Cars (AU)", "Kia Certified Used Cars (ZA)", "Kleinanzeigen Germany (DE)", "Motus Select (ZA)", "Carfind (ZA)", "Nissan Used Cars (ZA)", "Just Cars Australia (AU)", "OnlyCars Australia (AU)", "Kijiji Canada (CA)", "Kijiji Canada compatibility (CA)", "MOTORS UK (GB)", "OLX Brazil (BR)", "Dubizzle Egypt Cars (EG)", "OLX Lebanon Cars (LB)", "OLX Kazakhstan Cars (KZ)", "OLX Pakistan (PK)", "OLX Poland Cars (PL)", "OLX Portugal Cars (PT)", "PistonHeads (GB)", "ikman.lk (LK)", "Chotot Cars (VN)", "Cheki Kenya (KE)", "Be Forward Japan (JP)", "AUTO.RIA Ukraine (UA)", "Kolesa Kazakhstan (KZ)", "Car From Japan (JP)", "Goo-net Japan (JP)", "SBT Japan (JP)", "TCV Japan (JP)", "SGCarMart (SG)", "AutoTrader South Africa (ZA)", "Car & Classic (GB)", "Kavak Mexico (MX)", "OLX Ukraine Cars (UA)", "OLX Romania Cars (RO)", "AutoChek Nigeria (NG)", "AutoChek Kenya (KE)", "AutoChek Ghana (GH)", "AutoChek Uganda (UG)", "AutoChek Cote d'Ivoire (CI)", "UsedCarsPhil (PH)", "Philkotse (PH)", "AutoDeal Philippines (PH)", "Carmudi Philippines (PH)", "Jiji Kenya (KE)", "Jiji Ghana (GH)", "Jiji Uganda (UG)", "Jiji Nigeria (NG)", "AutoScout24 France (FR)", "La Centrale (FR)", "Blocket Cars (SE)", "OLX Uzbekistan Cars (UZ)", "Mercado Libre Dominican Republic (DO)", "Mercado Libre Guatemala (GT)", "Mercado Libre Honduras (HN)", "Mercado Libre Nicaragua (NI)", "Mercado Libre Panama (PA)", "Mercado Libre Ecuador (EC)", "Mercado Libre Paraguay (PY)", "Mercado Libre El Salvador (SV)", "Dubizzle Oman Cars (OM)", "Dubizzle Kuwait Cars (KW)", "Dubizzle Qatar Cars (QA)", "Dubizzle Bahrain Cars (BH)", "AA Used Cars (GB)", "Autobazar.eu (SK)", "Autohero Germany (DE)", "Autohero Sweden (SE)", "Autohero Spain (ES)", "Autohero Italy (IT)", "Autohero France (FR)", "Autohero Netherlands (NL)", "Autohero Austria (AT)", "Autohero Poland (PL)", "Autohero Belgium (BE)", "PolovniAutomobili (RS)" ] }, "default": [] }, "includeHistory": { "title": "Export History", "type": "boolean", "description": "Advanced. Export historical observations instead of only the latest listing per vehicle.", "default": false }, "seenSince": { "title": "Seen Since", "type": "string", "description": "Advanced. Only return listings seen after this ISO date/time, for example 2026-05-01T00:00:00Z.", "default": "" }, "orderBy": { "title": "Sort By", "enum": [ "last_seen_desc", "price_asc", "price_desc", "year_desc" ], "type": "string", "description": "Advanced. Choose how matching rows are ordered before the limit is applied.", "default": "last_seen_desc" }, "offset": { "title": "Skip Rows", "minimum": 0, "type": "integer", "description": "Advanced. Skip this many matching rows. Use with Result Limit to page through large exports.", "default": 0 }, "includeTotalCount": { "title": "Exact Total Count", "type": "boolean", "description": "Advanced. Add an exact total match count to normal exports. Preview Only always counts.", "default": false }, "listingStatus": { "title": "Listing Status", "type": "array", "description": "Exact listing statuses, for example active or sold.", "items": { "type": "string" }, "default": [] }, "currencyCodes": { "title": "Currency", "type": "array", "description": "Exact currency codes, for example ZAR, USD, GBP, or EUR.", "items": { "type": "string" }, "default": [] }, "bodyTypes": { "title": "Body Type", "type": "array", "description": "Exact body type values from the stored listing data.", "items": { "type": "string" }, "default": [] }, "fuelTypes": { "title": "Fuel Type", "type": "array", "description": "Exact fuel values from the stored listing data.", "items": { "type": "string" }, "default": [] }, "transmissions": { "title": "Transmission", "type": "array", "description": "Exact transmission values from the stored listing data.", "items": { "type": "string" }, "default": [] }, "conditions": { "title": "Condition", "type": "array", "description": "Exact condition values from the stored listing data.", "items": { "type": "string" }, "default": [] } } }, "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 } } } } } } } } } }