PakWheels Used Cars Scraper

Scrape PakWheels.com — Pakistan's largest online marketplace for used and new cars. Search thousands of live used-car listings by keyword, make, city, price, year, mileage, fuel type, transmission and body type, or fetch complete details for specific listing URLs. No login, no cookies, and no paid proxy required.

What this actor does

• Two modes: search (keyword + filters across all listings) and byUrl (fetch full details for specific listing URLs)
• Rich filters: make, city, price range (PKR), model-year range, mileage range, fuel type, transmission, and body type
• Detail-page enrichment: byUrl mode adds color, body type, registration city, assembly (local/imported), and last-updated date on top of the standard fields
• Real-time data: every run reads the live PakWheels search results, so prices and availability are always current
• Empty fields are omitted — a field only appears on a record when PakWheels actually published that data for that listing

Output per car listing

• title — the listing headline, e.g. Toyota Corolla 2020 for sale in Lahore
• make — manufacturer, e.g. Toyota
• model — model name, e.g. Corolla, Yaris Sedan, Atto 2
• year — model year
• price — numeric price in PKR
• priceCurrency — always PKR
• mileageKm — odometer reading in kilometres
• city — city the car is listed in
• fuelType — Petrol, Diesel, CNG, LPG, Hybrid, Electric, etc.
• transmission — Manual or Automatic
• engineCapacityCc — engine displacement in cc
• imageUrl — main listing photo
• listingUrl — canonical PakWheels URL for the listing
• adId — PakWheels internal ad reference number
• color — exterior color (mode=byUrl only)
• bodyType — Sedan, Hatchback, SUV, etc. (mode=byUrl only, when PakWheels has tagged it)
• registrationCity — city the vehicle is registered in, when different from the listing city (mode=byUrl only)
• assembly — Local or Imported (mode=byUrl only)
• lastUpdated — date the seller last updated the ad (mode=byUrl only)
• adRef — ad reference number as shown on the listing page (mode=byUrl only)
• features — list of tagged features, e.g. Alloy Wheels, Sun Roof, Air Conditioning, Infotainment System (mode=byUrl only, when the seller tagged any)
• recordType — always carListing
• scrapedAt — UTC timestamp of when the record was scraped

Input

Field	Type	Default	Description
mode	string	search	search (keyword + filters) or byUrl (fetch specific listing URLs)
searchQuery	string	Toyota Corolla	Free-text keyword — matches make, model, and title (mode=search)
make	select	–	Restrict to a manufacturer, e.g. toyota, honda, suzuki (mode=search)
city	select	–	Restrict to a city, e.g. lahore, karachi, islamabad (mode=search)
bodyType	select	–	Restrict to a body style, e.g. sedan, suv, hatchback (mode=search)
fuelType	select	–	Restrict to a fuel type, e.g. petrol, diesel, hybrid (mode=search)
transmission	select	–	manual or automatic (mode=search)
minPrice / maxPrice	integer	–	Price range in PKR (mode=search)
minYear / maxYear	integer	–	Model-year range (mode=search)
minMileage / maxMileage	integer	–	Odometer range in km (mode=search)
sortOrder	select	Default site ranking	Sort by updated date, price, model year, or mileage (asc/desc) (mode=search)
listingUrls	array	–	Full PakWheels listing URLs to fetch in detail (mode=byUrl)
maxItems	integer	50	Hard cap on emitted records (1–1000)
proxyConfiguration	object	Apify proxy (AUTO)	Optional — PakWheels does not require a proxy, but the free datacenter group is enabled by default for extra reliability

Example: search by keyword

{
  "mode": "search",
  "searchQuery": "Honda Civic",
  "maxItems": 50
}

Example: filtered search — Toyota sedans in Lahore, automatic, petrol, budget-priced

{
  "mode": "search",
  "make": "toyota",
  "city": "lahore",
  "bodyType": "sedan",
  "fuelType": "petrol",
  "transmission": "automatic",
  "minPrice": 2000000,
  "maxPrice": 6000000,
  "minYear": 2015,
  "maxYear": 2022,
  "maxItems": 100
}

Example: browse every listing in a city

{
  "mode": "search",
  "city": "karachi",
  "maxItems": 200
}

Example: fetch full details for specific listings

{
  "mode": "byUrl",
  "listingUrls": [
    "https://www.pakwheels.com/used-cars/toyota-corolla-2020-for-sale-in-lahore-11542999",
    "https://www.pakwheels.com/used-cars/honda-city-2018-for-sale-in-peshawar-11670942"
  ]
}

Use cases

• Car buyers — track price trends and find the best deals across cities before buying
• Dealerships — monitor competitor inventory and pricing in real time
• Market research — analyze used-car pricing, depreciation, and demand by make/model/city across Pakistan
• Price comparison tools — power a car-valuation or price-comparison app with fresh listing data
• Lead generation — build a feed of newly listed cars matching specific buyer criteria
• Data journalism — study automotive market trends in Pakistan (fuel-type adoption, EV growth, import vs. local assembly, etc.)

Data source / limitations

This actor reads PakWheels' public used-car search and listing pages — no login, cookies, or API key is required or supported. A small number of fields (bodyType, color, registrationCity, assembly, lastUpdated, adRef) are only available from the full listing detail page, so they're populated in byUrl mode but not in search mode (which reads the lighter-weight search-results page for speed). If PakWheels has not tagged a particular field for a listing (e.g. an older ad with no body type on file), that field is simply omitted from the record rather than showing a placeholder.

Free-text search currently works best with Latin-script (English/Romanized Urdu) keywords, matching how listings are titled on PakWheels; non-Latin script queries may return no results.

FAQ

Is this an official PakWheels product? No. This is an independent, third-party actor that reads PakWheels' publicly available web pages. It is not affiliated with or endorsed by PakWheels.

Do I need a PakWheels account, login, or API key? No. All data used by this actor is publicly visible on pakwheels.com without logging in.

How fresh is the data? Every run fetches live search results and listing pages at the time you run the actor, so prices and availability reflect what's currently posted.

Why do some records have more fields than others? search mode returns the fields available directly on the search-results page (fast, good for bulk browsing). byUrl mode fetches each listing's own page individually and adds a few extra fields (color, body type, registration city, assembly type, last-updated date) that only exist on the full listing page.

Can I combine multiple filters at once? Yes — make, city, bodyType, fuelType, transmission, price range, year range, and mileage range can all be combined in a single search run.

What currency are prices in? Pakistani Rupees (PKR), matching how PakWheels lists all of its prices.

Does this cover new cars too? No, this actor is scoped to PakWheels' used-car marketplace only.

What happens if my filters match zero listings? The actor finishes cleanly with zero output rows and a status message noting that no listings matched — it will not error out.