Guazi Used Car Scraper (Apify Actor)

Scrape used car listings from Guazi (en.guazi.com) — China's used-car export and auction platform — by keyword, brand/model, price, mileage, year, fuel type and more. Get buy-it-now prices, sealed-bid and live auctions, plus full spec sheets, photo galleries, per-port FOB prices, Guazi inspection reports and VIN (billed per enriched listing). Pay-per-event pricing — you pay only for the results you get.

Why scrape Guazi?

• Import pricing research — real FOB prices by destination port for used cars exported from China.
• Used-car market analysis — prices, mileage, age and grades for any brand/model across all trade types.
• Auction monitoring — track sealed-bid and live-auction inventory.
• EV & battery data — EV range, battery capacity and state-of-health for electrified vehicles.
• Vehicle condition — Guazi inspection grades (S–D), no-accident/no-water/no-fire flags, per-category check counts and VIN.

Features

Category	Capabilities
Search	Keyword, brand/model (auto-resolved to Guazi ids), or a ready-made Guazi URL
Filters	Price, mileage, model/registration/manufacture year, fuel, body type, seller type, condition grade, transmission, engine, horsepower, battery SOH, seats, country
Trade types	All, Buy It Now, Sealed-Bid Auctions, Live Auctions, New Cars, Fleet Cars
Sorting	Best match, price ↑/↓, newly listed, 1st-reg/mfg date, mileage ↑/↓
Enriched data	Full spec sheet, full photo gallery, per-port FOB prices, inspection report, VIN (masked), location, trim name — fetched per listing
Reliability	Deduplication across the whole run, graceful stop at your spending limit
Performance	Fast concurrent page fetching (15 workers, tunable), results in platform page order, bounded-memory streaming (flat RAM even on huge searches), window pipelining (the next window's pages download while the current one enriches), long-lived worker sessions (the EdgeOne cookie challenge is solved once per worker, not once per window), live enrichment progress logs

Pricing (pay-per-event)

You are charged only for what you receive, event by event:

• listing — charged for every listing saved to the dataset (the search data: price, mileage, year, specs, grade, image, URL, …).
• listing-detail — charged in addition for every enriched listing (enrichment is controlled by maxDetails; 0 = unlimited, i.e. every listing is enriched by default). Enriched listings include much more content, so they cost more than a plain listing.

Not charged: duplicate listings (deduped across the whole run), unavailable pages, empty results, and listings whose detail page is gone (they are still returned with their search fields, and no listing-detail is charged).

Maximum cost per run. You can set a spending limit in the Apify Console or via the API (maxTotalChargeUsd). The actor checks the limit, caps its own work so it fits the budget, and stops gracefully, keeping everything scraped so far.

Exact prices are configured by the actor owner in Apify Console and are intentionally not listed here — check the pricing on the Apify Store page, where you can also pick a discount tier.

Input

Field	Type	Default	Description
startUrls	URL list	–	One or more Guazi used-cars listing URLs. When set, all other search fields are ignored — every URL filter parameter is supported (see Start-URL example).
keyword	string	–	Free-text search term, e.g. BMW X5 (matched against title, brand, model and specs). Ignored when startUrls is set.
brand	string	–	Brand name in English as shown on en.guazi.com (e.g. BMW, Toyota, Mercedes-Benz); auto-resolved to a Guazi brandId.
model	string	–	Model/series name (e.g. X5 for BMW). Requires brand; auto-resolved to a seriesId.
tradeType	select	buyItNow	All listings / Buy It Now / Sealed-Bid Auctions / Live Auctions / New Cars / Fleet Cars.
priceMin / priceMax	integer	0	FOB price range in USD (buy-it-now vehicles). A max of 0 means no limit.
mileageMinKm / mileageMaxKm	integer	0	Mileage range in km. A max of 0 means no limit.
yearFrom / yearTo	integer	0	Model-year range (carYear). A max of 0 means no limit.
firstRegYearFrom / firstRegYearTo	integer	0	First-registration year range (licenseYear). A max of 0 means no limit.
mfgYearFrom / mfgYearTo	integer	0	Manufacture-year range (mfgDate). A max of 0 means no limit.
fuelType	select	any	Gasoline / Electric (BEV) / Range-extended (REEV) / Plug-in hybrid (PHEV) / Hybrid (HEV) / Diesel / Any.
bodyType	select	any	Sedan / SUV / Mini Van / Hatchback / Wagon / Pick up / Van / Truck / Any.
vehicleSource	select	any	Guazi Owned / Certified Dealer / Individual Seller / Any.
conditionGrade	select	any	Guazi inspection condition grade S–D, or any.
transmission	select	any	Manual (MT) / Automatic (AT) / Any.
engineMin / engineMax	number	0	Engine displacement range in liters. A max of 0 means no limit.
horsepowerMin / horsepowerMax	integer	0	Horsepower range (ps). A max of 0 means no limit.
batteryHealthMin / batteryHealthMax	integer	0	Battery state-of-health (SOH) range in %, for EVs. A max of 0 means no limit.
seats	string list	–	Seat-count codes as taken from a Guazi URL (e.g. from &seats=2,5).
sortBy	select	bestMatch	Best match / Lowest price / Highest price / Newly listed / Newest 1st reg. date / Newest mfg. date / Lowest mileage / Highest mileage.
country	string	–	Guazi country filter code(s) as taken from a Guazi URL (e.g. CN). Empty = all.
maxPages	integer	1	Result pages (20 items each) to scrape per search or start URL. 0 = unlimited — all available pages (derived from the API's total count). Stops earlier when results run out. Note: Guazi's API itself caps every search at 25 pages with the default bestMatch sort, or 80 pages with any other sort — see Results limit per search.
maxItems	integer	0	Stop after pushing this many listings in total. 0 = unlimited (maxPages still applies).
maxDetails	integer	0	Enrich this many listings with the full product-page data (see Enriched fields). 0 = unlimited — every scraped listing is enriched. Each enriched listing is additionally charged as a listing-detail event.

Start-URL example

https://en.guazi.com/used-cars/?tradeType=buyItNow&keyword=BMW&price=5000,20000&carYear=2018,2022&sort=price+asc

Start URLs are copied straight from en.guazi.com (or built by hand) — the actor translates every supported filter into the underlying API call:

• Filters (ranges are min,max, e.g. price=5000,20000): keyword, brandId, seriesId, price, roadHaul (thousands of km), carYear, mfgDate, licenseYear, fuelType, autoType, gearbox, drivetrain, carColor, seats, batteryHealth, batteryType, batteryCapacity, evRange, horsepower, engine, vehicleSourceClassificationCustomers, detectionLevels, country
• tradeType — buyItNow, sealedBid, liveAuction, newCars, fleetCars or all
• sort — the sort string from the Guazi URL (e.g. price+asc)
• page — first page to start from

Multiple start URLs are scraped as separate searches and deduplicated across the whole run.

Results limit per search (Guazi API)

Guazi's search API stops serving results after a fixed pagination depth, and every page beyond it returns a successful response with an empty list. The advertised totalCount (~176,000 for all buy-it-now cars) therefore cannot be reached by paging — by any client, from any IP; the site's own UI stops at the same point (verified against direct connections, real browsers and different IP classes). The actor detects this and ends the search cleanly; pages that return nothing are not charged.

sortBy	Pages per search (20 items/page)	Max listings per search
bestMatch (default; unsorted)	25	500
any explicit sort — priceAsc, priceDesc, newlyListed, regDateDesc, mfgDateDesc, mileageAsc, mileageDesc	80	1,600

The limit is per search (one filter combination / one start URL), so a run scraping several start URLs collects up to that many listings per search, deduplicated across the whole run. To surface more of the inventory, narrow the filters (brand, model, price, year, …) and split the search into several smaller ones, and/or pick an explicit sortBy, which raises the per-search ceiling from 500 to 1,600.

Output (default dataset)

Every listing is pushed as one dataset item in platform page order:

Field	Description
id	Guazi product id (unique key)
url	Listing page URL
title	Listing title
brand / brandId	Brand name / Guazi brand id
modelId / seriesName	Guazi series (model) id / resolved model name
carId	Trim/variant id (same as variantId when enriched)
priceUsd / priceText	Current price (number and original text)
originalPriceUsd / discountAmountUsd	List price and discount when promoted
mileageKm / mileageText	Mileage
manufactureDate / manufactureYear	Manufacture date / year
firstRegistrationDate	First registration date (YYYY-MM-DD)
engine / transmission / fuelType	Powertrain strings from the listing
isElectrified / batteryCapacity / evRange	EV flag and battery data
conditionGrade	Guazi inspection grade (S–D)
sellerType	Guazi Owned / Certified Dealer / Individual Seller
tradeType / auctionType	Listing category / auction label
image	Head photo URL
tags	Extra label texts from the listing
scrapedAt	UTC timestamp

seriesName is resolved automatically; a small minority of trim-level ids have no entry and stay null in the search-only output (it is back-filled from the product page when the listing is enriched).

Enriched fields (when maxDetails covers the listing)

Added on top of the search fields when a listing is enriched:

Field	Description
vinMasked	VIN (masked by Guazi, e.g. LSY**********2037)
variantId / variantUrl / trimName	Trim identity: variant id, its variant-page URL and the slug-derived trim name
driveType / bodyType / exteriorColor / modelYear / steering / location	Fields from the product-page spec table
horsepowerPs / curbWeightKg / dimensionsMm	Power (ps), curb weight, {lengthMm, widthMm, heightMm}
images / imageCount	Full photo gallery
exteriorImages / interiorImages / detailImages	Gallery split by category
portPrices	Per-port FOB prices: [{port, code, usd, default}]
defaultPortPriceUsd	FOB price at the default export port
batteryHealthSoH / batteryCapacity / evRange	Battery state of health (%) and numeric EV data
specifications	Full manufacturer spec sheet grouped by section, e.g. {"Engine": {"Displacement (L)": "2", …}}
inspection	Guazi inspection report: grade, guaziReport, cleanCar (noAccident / noWater / noFire) and categoryChecks ({category: {normal, abnormal}})
featureHighlights	Feature highlight texts
clueId	Guazi internal clue id

Note: carId (search) and variantId (detail) are the same ID; the per-vehicle unique key is id/productId.

Support & Feature Requests 📬

If you encounter any issues or have ideas for new features, please don't hesitate to open an issue. We value your feedback and will do our best to improve the scraper based on your suggestions.

Requesting additional data fields

The scraper currently extracts the fields listed in Output and Enriched fields, but if you need additional data points not included in the output, please open an issue describing the required fields. We'll look into incorporating them into the actor.

Legal note

Scraped data is provided as-is for personal and commercial use at your own risk. Respect Guazi's terms of service and applicable laws in your jurisdiction.

---

SEO Keywords: guazi scraper, en.guazi.com scraper, used car scraper, china used cars, guazi auction scraper, guazi buy it now, used car price data, vehicle inspection report, car VIN scraper, apify car actor, import car pricing, china car export