{ "openapi": "3.0.1", "info": { "title": "PakWheels Used Cars Scraper", "description": "Scrape used-car listings from PakWheels.com, Pakistan's largest car marketplace. Search by keyword, make, city, price, year, mileage, fuel type, transmission, and body type, or fetch full details from specific listing URLs.", "version": "1.0", "x-build-id": "KwL5Zd2fi5lBxHZBE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~pakwheels-used-cars-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-pakwheels-used-cars-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/crawlerbros~pakwheels-used-cars-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-pakwheels-used-cars-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/crawlerbros~pakwheels-used-cars-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-pakwheels-used-cars-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byUrl" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search keyword (mode=search)", "type": "string", "description": "Free-text keyword, e.g. `Honda Civic`, `Toyota Corolla 2020`, `Suzuki Alto`. Matches make, model, and title text.", "default": "Toyota Corolla" }, "make": { "title": "Make (mode=search)", "enum": [ "", "toyota", "suzuki", "honda", "daihatsu", "kia", "hyundai", "changan", "mg", "byd", "haval", "jaecoo", "tank", "nissan", "mitsubishi", "audi", "bmw", "mercedes-benz", "land-rover", "range-rover", "lexus", "chevrolet", "mazda", "subaru", "volkswagen", "mini", "porsche", "jaguar", "ford", "faw", "dfsk", "jetour", "omoda", "chery", "gac", "jac", "jmc", "jmev", "jw-forland", "dongfeng", "deepal", "hyptec", "ora", "seres", "forthing", "united", "prince", "sogo", "rinco", "adam", "aion", "alektra", "baic", "gugo", "honri", "inverex", "master", "power", "isuzu", "hino", "infiniti", "volvo", "opel", "peugeot", "fiat", "chrysler", "dodge", "jeep", "gmc", "hummer", "cadillac", "buick", "vauxhall", "rolls-royce", "bentley", "smart", "tesla", "datsun", "daewoo", "daehan", "austin", "morris", "willys", "proton", "ssangyong", "classic-cars" ], "type": "string", "description": "Restrict results to a specific car manufacturer.", "default": "" }, "city": { "title": "City (mode=search)", "enum": [ "", "karachi", "lahore", "islamabad", "rawalpindi", "faisalabad", "multan", "peshawar", "quetta", "sialkot", "gujranwala", "hyderabad", "sargodha", "bahawalpur", "sukkur", "mardan", "sheikhupura", "gujrat", "kasur", "abbottabad" ], "type": "string", "description": "Restrict results to a specific city.", "default": "" }, "bodyType": { "title": "Body type (mode=search)", "enum": [ "", "sedan", "hatchback", "suv", "crossover", "compact-sedan", "compact-hatchback", "compact-suv", "van", "mini-van", "micro-van", "mpv", "pick-up", "double-cabin", "single-cabin", "station-wagon", "coupe", "convertible", "off-road-vehicles", "high-roof", "truck", "mini-vehicles" ], "type": "string", "description": "Restrict results to a specific body style.", "default": "" }, "fuelType": { "title": "Fuel type (mode=search)", "enum": [ "", "petrol", "diesel", "cng", "lpg", "hybrid", "phev", "electric", "reev" ], "type": "string", "description": "Restrict results to a specific engine/fuel type.", "default": "" }, "transmission": { "title": "Transmission (mode=search)", "enum": [ "", "manual", "automatic" ], "type": "string", "description": "Restrict results to a specific transmission type.", "default": "" }, "sortOrder": { "title": "Sort order (mode=search)", "enum": [ "", "bumped_at-desc", "bumped_at-asc", "price-asc", "price-desc", "model_year-desc", "model_year-asc", "mileage-asc", "mileage-desc" ], "type": "string", "description": "Order search results by PakWheels' own sort options.", "default": "" }, "minPrice": { "title": "Min price (PKR)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Drop listings priced below this amount (PKR)." }, "maxPrice": { "title": "Max price (PKR)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Drop listings priced above this amount (PKR)." }, "minYear": { "title": "Min model year", "minimum": 1980, "maximum": 2100, "type": "integer", "description": "Drop listings with a model year before this." }, "maxYear": { "title": "Max model year", "minimum": 1980, "maximum": 2100, "type": "integer", "description": "Drop listings with a model year after this." }, "minMileage": { "title": "Min mileage (km)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Drop listings with odometer reading below this (km)." }, "maxMileage": { "title": "Max mileage (km)", "minimum": 0, "maximum": 2000000, "type": "integer", "description": "Drop listings with odometer reading above this (km)." }, "listingUrls": { "title": "Listing URLs (mode=byUrl)", "type": "array", "description": "Full PakWheels used-car listing URLs to fetch in detail, e.g. `https://www.pakwheels.com/used-cars/toyota-corolla-1999-for-sale-in-lahore-11649652`.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. PakWheels serves listings without anti-bot challenges, so a proxy is not required. Leave the free AUTO datacenter group enabled for extra reliability, or disable it entirely.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }