Banggood Product & Price Scraper

Scrape Banggood.com — a global online marketplace for affordable electronics, phone accessories, RC/hobby gear, tools, home & garden, lighting, automotive parts, sports equipment, toys, and fashion shipped worldwide. Search by keyword (with sort control), browse any of Banggood's 11 top-level departments or a curated set of popular subcategories, or fetch complete product detail (price, discount, rating, review breakdown, specifications, shipping, images, brand, category) for a list of product URLs. No login, no cookies required.

What this actor does

• Three modes: search (keyword, auto-paginated, sortable), byCategory (browse a department or subcategory), productDetail (full detail by URL)
• Sort control: order search results by popularity, newest, most reviews, or price (low-to-high / high-to-low)
• Real-time pricing: current price, list price, and discount percentage, fetched live on every run
• Ratings & reviews: review count on every product; star rating and a full 5-star-to-1-star review breakdown on product detail pages
• Optional review sample: a small set of featured customer reviews (reviewer, country, rating, date, text, helpful votes, photos) on request
• Product specifications: structured spec sheet, feature list, and package contents, when Banggood publishes them for that product
• Shipping snapshot: ship-from warehouse, shipping cost, destination, and estimated delivery window (detail mode)
• Rich media: main image plus a gallery of additional product photos (detail mode)
• Filters: price range, minimum discount, minimum review count, minimum rating, on-sale-only
• Empty fields are omitted — a product with no reviews yet simply has no rating/reviewCount field, never a fake 0

Output per product

• productId — Banggood's internal numeric product ID
• title — product name
• brand — manufacturer/brand name (detail mode)
• description — short product summary (detail mode)
• price — current/final price
• listPrice — original price before discount
• discountPercent — percentage off, if on sale
• currency — ISO 4217 currency code (e.g. USD)
• rating — average star rating, 0–5 (detail mode only; omitted if the product has no reviews yet)
• reviewCount — number of customer reviews
• ratingDistribution[] — review breakdown by star level, e.g. {"stars": 5, "count": 1463, "percent": 93.9} (detail mode; omitted with no reviews)
• topReviews[] — a small sample of featured reviews when includeTopReviews is enabled: reviewerName, country, countryCode, rating, date, text, helpfulCount, images[] (detail mode)
• specifications — key/value spec sheet, e.g. {"Brand": "Baseus", "Color": "Black"} (detail mode, when published for that product)
• features[] — bullet-point feature list (detail mode, when published)
• packageContents[] — what's included in the box (detail mode, when published)
• imageUrl — main product image
• images[] — additional gallery images (detail mode)
• category — full breadcrumb category path (detail mode)
• breadcrumbs[] — category path as an array (detail mode)
• availabilityText — stock/shipping status text, when shown (detail mode)
• warehouse — ship-from warehouse code, e.g. CN (detail mode)
• shippingCost — shipping cost text, e.g. Free shipping (detail mode)
• shipToCountry — destination country Banggood resolved for the request (detail mode; varies with the run's origin — see FAQ)
• estimatedDelivery — estimated delivery date range text (detail mode)
• productUrl — canonical Banggood product page URL
• recordType: "product", scrapedAt, sourceUrl

Input

Field	Type	Default	Description
mode	string	search	search / byCategory / productDetail
searchQuery	string	phone case	Free-text keyword (mode=search)
categoryPath	string (select)	Wholesale-Electronics-ca-2001.html	Department or curated subcategory to browse (mode=byCategory) — all 11 top-level departments plus 25 popular subcategories
productUrls	array	–	Full product page URLs to fetch (mode=productDetail)
sortBy	string (select)	popular	Result order for mode=search: popular / newest / mostReviews / priceAsc / priceDesc. No effect on mode=byCategory (Banggood's category pages have no sort control)
minPrice	number	–	Drop products priced below this
maxPrice	number	–	Drop products priced above this
minDiscountPercent	int	–	Only products discounted by at least this %
minReviewCount	int	–	Drop products with fewer reviews
minRating	number	–	Drop products rated below this (0–5); mode=productDetail only
onSaleOnly	boolean	false	Only currently-discounted products
includeTopReviews	boolean	false	Fetch a small sample of featured reviews per product (mode=productDetail only) — one extra page load per product, so it's opt-in
maxItems	int	60	Hard cap on emitted records (1–2000)

Example: keyword search with a price ceiling

{
  "mode": "search",
  "searchQuery": "led strip light",
  "maxPrice": 20,
  "onSaleOnly": true,
  "maxItems": 40
}

Example: keyword search sorted by price, low to high

{
  "mode": "search",
  "searchQuery": "rc car",
  "sortBy": "priceAsc",
  "maxItems": 40
}

Example: browse a category for well-reviewed items

{
  "mode": "byCategory",
  "categoryPath": "Wholesale-Sports-and-Outdoors-ca-6001.html",
  "minReviewCount": 5,
  "maxItems": 50
}

Example: browse a popular subcategory

{
  "mode": "byCategory",
  "categoryPath": "Wholesale-Smart-Watch-ca-2210.html",
  "onSaleOnly": true,
  "maxItems": 30
}

Example: full detail (with a sample of reviews) for a specific product

{
  "mode": "productDetail",
  "productUrls": [
    "https://www.banggood.com/Baseus-SkyRing-Series-Magnetic-Phone-Case-p-1998466.html"
  ],
  "includeTopReviews": true
}

Use cases

• Price monitoring — track discounts and price drops across categories, sorted low-to-high or high-to-low
• Dropshipping research — find trending, highly-discounted products by niche, including RC/hobby, tools, and home & garden
• Market intelligence — compare pricing, ratings, and full review breakdowns across competing listings
• Deal aggregation — feed on-sale, highly-rated, newest-first products into a deals site or newsletter
• Assortment analysis — survey category breadth across all 11 top-level departments plus popular subcategories
• Product page audits — pull specifications, package contents, and shipping details for catalog/listing QA

FAQ

Is this affiliated with Banggood? No — this is an independent third-party actor that reads Banggood's public, unauthenticated storefront pages.

Do I need to provide cookies, an account, or a proxy? No. All modes work from a fresh session with no login.

Why do some products have no rating or reviewCount? rating is only ever present on productDetail results, and only when the product has at least one real review — a brand-new listing doesn't get a fake 0 rating. reviewCount is present in all modes.

What currency are prices in? Prices reflect whatever currency Banggood serves for the request's origin (typically USD from US-based traffic). The currency field on each record tells you exactly which one.

Why does shipToCountry change between runs? Like currency, the shipping snapshot (shipToCountry, shippingCost, estimatedDelivery) reflects whatever destination Banggood resolves for the request's origin. It's real, live data — just specific to where that particular run's traffic came from, not a fixed "home country" setting.

Does sortBy work in every mode? No — only mode=search. Banggood's category browse pages don't have a sort control at all, so sortBy is ignored in mode=byCategory (and irrelevant to mode=productDetail).

Why isn't every product's specifications/features/packageContents populated? Banggood only publishes a structured spec sheet for some categories (mostly electronics/hardware) — apparel, bags, and similar categories often don't have one. When it's not published, these fields are simply omitted rather than filled with guesses.

Is categoryPath limited to top-level departments? No — it includes all 11 of Banggood's top-level departments plus a curated set of 25 popular, verified-active subcategories (smart watches, RC cars, security cameras, dash cams, and more). Banggood has hundreds of narrower subcategories beyond this list; the curated set focuses on the ones with consistently strong inventory.

Is there a way to get flash deals, coupons, or top-seller rankings? Banggood's dedicated flash-deals/coupon/ranking pages use a different, AJAX-widget-driven layout than its standard search/category listing pages, so they aren't covered by this actor. You can get very similar results with the listing pages this actor already supports: onSaleOnly: true for deals, or sortBy: "newest" / sortBy: "mostReviews" for trending/new items, in either search or byCategory mode.

Can I scrape a specific seller's/brand's storefront? Banggood operates primarily as a first-party retailer rather than a multi-seller marketplace, and doesn't expose a per-listing seller storefront page the way some marketplaces do — so there's no byStore mode.

How many products can I get per run? search paginates automatically up to maxItems or until results are exhausted. byCategory returns a single page (Banggood's category browse doesn't expose reliable further-page navigation) — typically 40-64 products, capped by maxItems. productDetail returns exactly one record per URL you supply.

Why does productDetail need full URLs instead of just product IDs? Banggood product URLs encode the SEO slug together with the ID; the slug isn't derivable from the ID alone, so a valid URL (from a search/category run, or copied from your browser) is required.

How fresh is the price data? Prices are fetched live on every run directly from Banggood's pricing service — not cached.

Why don't some search/byCategory results show listPrice/discountPercent even though the item is on sale? The current buyable price is always accurate. listPrice and discountPercent on listing results come from a reference price shown on the listing card itself, which Banggood doesn't always populate consistently. For a guaranteed, authoritative discount figure, use mode=productDetail on that product's URL.