{ "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 websites with filters for brand, model, price, year, mileage, fuel, transmission, country, and history.", "version": "0.0", "x-build-id": "SAf6PKPo7MBaw0W3n" }, "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": { "websites": { "title": "Websites", "type": "array", "description": "Optional. Choose specific source websites already stored in Supabase. If empty, country selector is used (or a lightweight default if countries are also empty).", "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", "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)", "kijijiautos.ca (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)", "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": [] }, "countries": { "title": "Countries", "type": "array", "description": "Optional. If websites is empty, all stored sources in selected countries are queried. If websites is set, this narrows websites to those countries.", "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": [] }, "estimateOnly": { "title": "Estimate Results Only", "type": "boolean", "description": "Recommended before large exports. Runs a count query for the selected filters, shows about how many rows this exact run would return with the current limit and offset, and exports no dataset rows.", "default": false }, "brandQuery": { "title": "Brand Query", "type": "string", "description": "Recommended brand filter. Single value, case-insensitive. Example: Toyota. Shorthand like VW is supported.", "default": "" }, "modelQuery": { "title": "Model Query", "type": "string", "description": "Recommended model filter. Single value, case-insensitive. Example: Corolla.", "default": "" }, "yearMin": { "title": "Min Year", "minimum": 0, "type": "integer", "description": "Only output listings with year >= yearMin. 0 disables.", "default": 0 }, "yearMax": { "title": "Max Year", "minimum": 0, "type": "integer", "description": "Only output listings with year <= yearMax. 0 disables.", "default": 0 }, "minPrice": { "title": "Min Price", "minimum": 0, "type": "integer", "description": "Only output rows with price >= Min Price (native listing currency). 0 disables.", "default": 0 }, "maxPrice": { "title": "Max Price", "minimum": 0, "type": "integer", "description": "Only output rows with price <= Max Price (native listing currency). 0 disables.", "default": 0 }, "includeHistory": { "title": "Include History", "type": "boolean", "description": "Switch from current inventory rows to historical listing snapshots. Current mode returns the latest row per listing; history mode can return multiple observations for the same listing over time.", "default": false }, "limit": { "title": "Max Results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum rows to return. Start small while testing filters, or use Estimate Results Only first.", "default": 1000 }, "offset": { "title": "Skip Results", "minimum": 0, "type": "integer", "description": "Skip this many matching rows before returning results. Useful for paging through large result sets.", "default": 0 }, "orderBy": { "title": "Order By", "enum": [ "last_seen_desc", "price_asc", "price_desc", "year_desc" ], "type": "string", "description": "Sort order for Supabase results.", "default": "last_seen_desc" }, "seenSince": { "title": "Seen Since", "type": "string", "description": "Only return rows seen after this ISO timestamp, for example 2026-05-01T00:00:00Z. In history mode this applies to history observations; in current mode it applies to the latest listing state timestamps.", "default": "" }, "currencyCodes": { "title": "Currency Codes", "type": "array", "description": "Optional currency filters such as ZAR, USD, GBP, or EUR.", "items": { "type": "string" }, "default": [] }, "listingStatus": { "title": "Listing Status", "type": "array", "description": "Optional listing status filters such as active, sold, removed, or unknown.", "items": { "type": "string" }, "default": [] }, "bodyTypes": { "title": "Body Types", "type": "array", "description": "Optional exact body type filters for current listings or history snapshots.", "items": { "type": "string" }, "default": [] }, "fuelTypes": { "title": "Fuel Types", "type": "array", "description": "Optional exact fuel filters for current listings or history snapshots.", "items": { "type": "string" }, "default": [] }, "transmissions": { "title": "Transmissions", "type": "array", "description": "Optional exact transmission filters for current listings or history snapshots.", "items": { "type": "string" }, "default": [] }, "conditions": { "title": "Conditions", "type": "array", "description": "Optional exact condition filters for current listings or history snapshots.", "items": { "type": "string" }, "default": [] }, "mileageMin": { "title": "Min Mileage", "minimum": 0, "type": "integer", "description": "Only output listings with mileage >= Min Mileage. 0 disables.", "default": 0 }, "mileageMax": { "title": "Max Mileage", "minimum": 0, "type": "integer", "description": "Only output listings with mileage <= Max Mileage. 0 disables.", "default": 0 } } }, "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 } } } } } } } } } }