# Banggood Scraper - Products, Prices, Specs & Reviews (`scrapesage/banggood-scraper`) Actor

Scrape Banggood by keyword, category, URL or product ID: regular and new-user prices for any ship-to country, discount, stock, units sold, shipping cost and delivery dates, variants, specs, images and reviews. Monitor price drops. Independent tool, not affiliated with Banggood.

- **URL**: https://apify.com/scrapesage/banggood-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** E-commerce, Lead generation, Agents
- **Features:** Limited permissions
- **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Banggood Scraper - Products, Prices, Stock, Shipping & Reviews

> **Disclaimer:** This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Banggood or any of its subsidiaries. All trademarks mentioned are the property of their respective owners. "Banggood" is referenced only to describe the publicly available website this Actor collects data from.

Extract **complete Banggood product data for any ship-to country**: the **regular price** a buyer pays and Banggood's **first-order new-user price**, discount, **stock count**, **units sold**, **shipping cost and delivery dates**, the **full variant matrix with each option's own price and stock**, wholesale prices, specifications, description, all images, product videos, and **buyer reviews**. Built for **dropshipping product research, repricing, catalog building and price/stock monitoring**.

No login, no API key, no browser - search by keyword, paste product, search or category URLs, or list product IDs.

### Why this Banggood scraper?

Banggood prices every product per destination country and shows shoppers a first-order "New User" deal on its search results. This actor reads the price a regular buyer in **your** chosen country actually pays, and keeps the new-user deal as a separate column:

| Data | This actor |
| --- | --- |
| Keyword, category and product-ID input | ✅ all three, plus file import |
| Price for a chosen ship-to country (196 countries) | ✅ |
| Regular price vs first-order new-user price | ✅ both, labelled |
| Units sold, stock count, wishlist and Q\&A counts | ✅ |
| Shipping cost, method and estimated delivery dates | ✅ every option |
| Ships-from warehouse filter (CN, HK, US, UK, EU) | ✅ checked per product |
| Variant matrix with each option's price and stock | ✅ |
| Wholesale (quantity) prices | ✅ |
| Description, specifications, images and product videos | ✅ |
| Star-rating histogram | ✅ |
| Buyer reviews: newest first, star filter, photos, original text + translation | ✅ opt-in |
| Prices in 49 currencies with Banggood's own exchange rates | ✅ |
| Price-drop / restock monitor (only new or changed products) | ✅ |

### What you get

| Field | What it holds |
|---|---|
| `title`, `brand`, `sku`, `url`, `image` | Product name, Banggood's brand tag, Banggood SKU, product page, main image |
| `price`, `originalPrice`, `discountPercent` | Regular price for the ship-to country (product page figure), the struck-through price and Banggood's discount |
| `newUserPrice` | Banggood's first-order "New User" price shown on search results (when it differs) |
| `priceUsd`, `originalPriceUsd`, `currency` | US-dollar values next to the converted ones |
| `priceMin`, `priceMax`, `variants[]` | Cheapest and dearest option, and every option combination with its own price, stock and availability |
| `wholesalePrices[]` | Quantity price tiers, when Banggood offers them |
| `inStock`, `stock`, `stockMessage`, `processingTime` | Availability, units in stock, Banggood's stock text and handling time |
| `soldCount`, `wishlistCount`, `questionsCount` | Units sold, wishlist adds, answered questions |
| `rating`, `reviewsCount`, `ratingHistogram` | Average rating, review count, count per star |
| `shipping`, `shippingCost`, `deliveryDays`, `shippingOptions[]` | Default shipping method, cost, delivery days and dates; every shipping option |
| `warehouse`, `availableWarehouses[]`, `shipToCountry` | Where it ships from, every warehouse it is stocked in, and the country the prices are for |
| `category`, `categoryId`, `breadcrumb[]` | Banggood category path |
| `description`, `specifications`, `images[]`, `descriptionImages[]`, `videos[]` | Full description, specification list, gallery, description images, YouTube videos |
| `options[]`, `variesBy`, `defaultVariant` | Option groups (colour, size, plug ...) and the option the page opens with |
| `policies[]`, `keywords` | Banggood's buyer guarantees and the page's keywords |
| `searchTerm`, `searchRank` | The keyword and the product's position in Banggood's results |
| `changeType`, `previousPrice` | Monitor mode: what changed since the last run |

Review records (`type: "review"`): `stars`, `dateIso`, `author`, `country`, `content` (the reviewer's own words), `contentTranslated` (English, when the review is in another language), `photos[]`, `photosCount`, `helpfulCount`, plus the product's `productId`, `productTitle` and `productUrl`.

### Use cases

- **Dropshipping product research** - find products by keyword or category and compare price, units sold, rating, stock and delivery time for the country you sell into.
- **Repricing & price intelligence** - track the regular price, the struck-through price and the new-user deal per country, in your own currency.
- **Local-warehouse sourcing** - list only products that ship from Banggood's US, UK or EU warehouses for fast delivery.
- **Catalog & content building** - pull titles, descriptions, specifications, images, videos and the full variant matrix.
- **Review mining** - newest reviews first, or only 1-2 star reviews, with photos and translations, to vet products before sourcing.
- **Price-drop & restock alerts** - schedule recurring runs in monitor mode and receive only products whose price or stock changed.

### How to use

1. [Sign up for Apify](https://console.apify.com/sign-up) - the free plan is enough to try this actor.
2. Open the **Banggood Scraper**, enter search keywords (or paste Banggood URLs or product IDs), choose the ship-to country and currency, and click **Start**.
3. Watch results stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML or RSS - or pull results through the [Apify API](https://docs.apify.com/api/v2).

### Input

```json
{
    "searchTerms": ["mini drone", "led strip"],
    "shipToCountry": "GB",
    "currency": "GBP",
    "warehouse": "ANY",
    "sort": "default",
    "maxProducts": 100,
    "includeProductDetails": true,
    "includeReviews": false,
    "monitorMode": false
}
```

- **searchTerms** - keywords; each one is its own product feed in Banggood's ranking (60 products per page).
- **startUrls** - product pages (`…-p-<id>.html`), search pages (`/search/<kw>.html`), category pages (`…-c-<id>.html`) or review pages (`…-reviews-p<id>.html`, the product plus its reviews). A linked or uploaded text file of URLs works too.
- **urlsFromFile** - paste URLs and/or product IDs, one per line, or one link to a .txt, .csv or Google Sheet.
- **productIds** - Banggood product IDs (e.g. `1940642`).
- **shipToCountry** - the buyer's country (default United States). Prices, discounts, shipping and the warehouses on offer all follow it.
- **currency** - 49 currencies, converted with Banggood's own exchange rates.
- **warehouse** - only products that ship from CN, HK, US, UK or EU (CZ / PL) warehouses.
- **sort** - Popular, Newest, Price low to high, Price high to low, Most reviews.
- **minPrice / maxPrice / fourStarPlus** - filters on the regular price and rating.
- **includeProductDetails** *(default on)* - the full record (description, specifications, images, variants with prices, every shipping option). Off = a faster, cheaper discovery row that still has price, discount, stock, units sold, rating and default shipping.
- **includeReviews**, **maxReviewsPerProduct**, **reviewsSort** (most recent / top), **reviewStars** (e.g. only 1 and 2 stars).
- **monitorMode** / **monitorKey** - deliver only new or changed products on each run.

### Output

One record per product (`type: "product"`), plus optional review records (`type: "review"`). A full-detail row, shortened:

```json
{
    "type": "product",
    "productId": "1940642",
    "title": "JJRC H36 Mini 2.4G 4CH 6 Axis Headless Mode RC Drone Quadcopter RTF",
    "brand": "Eachine",
    "sku": "SKUJ18905",
    "url": "https://www.banggood.com/JJRC-H36-Mini-2_4G-4CH-6-Axis-Headless-Mode-RC-Drone-Quadcopter-RTF-p-1940642.html",
    "price": 23.99,
    "originalPrice": 60.74,
    "discountPercent": 61,
    "currency": "USD",
    "newUserPrice": 17.99,
    "priceMin": 21.99,
    "inStock": true,
    "stock": 5,
    "processingTime": "Ships in 24 hours",
    "soldCount": 181615,
    "wishlistCount": 1366,
    "questionsCount": 431,
    "rating": 4.93,
    "reviewsCount": 11417,
    "ratingHistogram": { "1": 32, "2": 25, "3": 72, "4": 488, "5": 10800 },
    "category": "RC Quadcopters",
    "breadcrumb": ["Toys Hobbies and Robot", "RC Drones", "RC Quadcopters"],
    "warehouse": "CN",
    "shipToCountry": "US",
    "shippingCost": 3.99,
    "deliveryDays": "20-44",
    "shipping": { "method": "Standard Shipping (Special)", "cost": 3.99, "deliveryDaysMin": 20, "deliveryDaysMax": 44, "estimatedDelivery": "Oct 28th-Nov 20th,2026", "tracked": true },
    "variesBy": "Color, Battery, Mode",
    "variantsCount": 4,
    "variants": [
        { "option": "Grey / One Battery / Mode 2 (Left Hand Throttle)", "price": 21.99, "currency": "USD", "stock": 0, "availability": "OutOfStock" },
        { "option": "Blue / Two Batteries / Mode 2 (Left Hand Throttle)", "price": 23.99, "currency": "USD", "stock": 5, "availability": "InStock" }
    ],
    "images": ["https://imgaz.staticbg.com/thumb/large/oaupload/banggood/images/EA/F8/3a973f36-016a-43ac-9d4f-841988944d90.jpg.webp"],
    "videos": ["https://www.youtube.com/watch?v=OmIgR2u7IGI"],
    "description": "JJRC H36 Mini 2.4G 4CH 6 Axis Headless Mode RC Quadcopter RTF\n\nDescription:\nItem name: JJRC H36 Mini Quadcopter ...",
    "specifications": { "Type": "Indoor Toys", "Brand": "JJRC", "Construction": "Unfoldable" },
    "policies": ["7 Days DOA Guarantee", "Quality Guarantee", "No Reason Returns"],
    "searchTerm": "mini drone",
    "searchRank": 3
}
```

```json
{
    "type": "review",
    "productId": "1940642",
    "productTitle": "JJRC H36 Mini 2.4G 4CH 6 Axis Headless Mode RC Drone Quadcopter RTF",
    "stars": 5,
    "dateIso": "2026-09-25",
    "author": "Darek",
    "country": "Poland",
    "countryCode": "PL",
    "content": "Everything ok. Good seller.",
    "photosCount": 0,
    "helpfulCount": 0
}
```

### Good to know

- **Prices follow the ship-to country.** Banggood sets prices, discounts and shipping per destination; every row says which country (`shipToCountry`) its figures are for. The default is the United States.
- **`price` is the regular price; `newUserPrice` is a first-order deal.** Banggood's search results show a "New User" price that only applies to a shopper's first order; it is delivered separately and never as `price`.
- **Overseas warehouses are regional.** The US warehouse is offered to buyers in the US and Canada, the UK warehouse to UK buyers, the EU warehouses (CZ, PL) to EU buyers; picking a warehouse sets the matching region unless you chose a ship-to country. Banggood no longer runs an Australian warehouse. Banggood's own "Ships from" filter misses some products, so the actor checks each product's warehouses itself.
- **No exact match = no rows.** For a keyword with no exact match Banggood shows loosely related products; the actor reports "no exact match" instead of delivering them.
- **Some fields only exist for some products.** Banggood tags a brand only on brand-registered products; some products have no separate specification list (the details are in the description) and some descriptions are images only; `priceMin`/`priceMax` appear only when options are priced differently, `wholesalePrices` only when quantity tiers exist, `videos` only when the product has one.
- **Sort orders are Banggood's own ranking**, delivered in the order Banggood returns it (`searchRank`). Its price sorts are approximate, so sort the `price` column yourself when you need a strict order.
- **Reviews arrive two at a time** on Banggood, so very large review counts take longer to collect.
- **Reviews come after the products in the dataset.** With 50 or more products, the Console's Reviews view therefore opens on empty pages; the run's final message names the page where the reviews start. Exports (JSON, CSV, Excel) and the API list every review.

### How much does it cost to scrape Banggood?

This Actor uses Apify's **pay-per-event** pricing: you are charged only for the results it delivers, with no monthly rental and no start fee. The events it can charge are:

- **Product** - one product row without the product-page details (includeProductDetails off, or when a product's page could not be read).
- **Product detail** - one full product row with the product-page details (the default).
- **Review** - one buyer review row.

The current price of each event is shown on the **Pricing** tab of this page. Set a maximum total charge on the run if you want a hard cap on spend, and use the input limits to control how much the Actor fetches.

### Automate & schedule

Run this actor on autopilot and pull results into your own stack:

- **[Apify API](https://docs.apify.com/api/v2)** - start runs, fetch datasets, and manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** - official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** - run it hourly or daily to watch a keyword or product set; pair with **monitorMode** to receive only price drops and restocks.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** - trigger downstream actions (repricer update, Slack alert, sheet append) the moment a run finishes.

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/banggood-scraper').call({
    searchTerms: ['mini drone'],
    shipToCountry: 'US',
    currency: 'USD',
    monitorMode: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} new or changed Banggood products`);
```

### Integrate with any app

Connect the dataset to 5,000+ apps - no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** - multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** - push new products or price drops into Sheets, Airtable or your store.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** - get notified when a monitored keyword finds a price drop or restock.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** - auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** - pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** - trigger runs from commits or releases.

### Use with AI assistants (MCP)

The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** - ask your assistant to "find the best-selling 4-star+ mini drones on Banggood that ship from the US warehouse, with their prices and delivery times" and let it run this scraper for you.

### Agent-ready: autonomous payments (x402 & Skyfire)

This actor is **agent-ready**: AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards:

- **[x402](https://docs.apify.com/platform/integrations/x402)**: an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp), with no account and no API key.
- **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)**: agent-to-service payments for fully autonomous AI-agent workflows.

Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes.

### More scrapers from scrapesage

Build a complete **e-commerce & dropshipping data stack** across the marketplaces your products come from and sell on:

- **[AliExpress Scraper](https://apify.com/scrapesage/aliexpress-scraper)** - products, prices, orders sold, variants & supplier leads.
- **[Made-in-China Scraper](https://apify.com/scrapesage/made-in-china-scraper)** - B2B suppliers, products & company contacts.
- **[TradeIndia Scraper](https://apify.com/scrapesage/tradeindia-scraper)** - Indian B2B suppliers & product listings.
- **[eBay Scraper](https://apify.com/scrapesage/ebay-scraper)** - active listings on 10 eBay marketplaces, prices, item details and seller leads.
- **[Poshmark Scraper](https://apify.com/scrapesage/poshmark-scraper)** - fashion resale listings, sold comps & seller leads.
- **[Reverb Scraper](https://apify.com/scrapesage/reverb-scraper)** - musical-instrument marketplace, price guide & seller leads.
- **[Shopify Store Scraper](https://apify.com/scrapesage/shopify-store-scraper)** - products, prices & inventory from any Shopify store.
- **[Gumtree Scraper](https://apify.com/scrapesage/gumtree-scraper)** - UK classifieds listings, prices & seller leads.

### Tips

- **Sell into one country?** Set **shipToCountry** to it - prices, discounts, shipping cost and delivery dates are then the ones your buyers see.
- **Fast local delivery:** combine **warehouse** (US, UK or EU) with a keyword to list only products stocked near your buyers.
- **Cheap discovery pass:** turn **includeProductDetails** off - rows still carry price, discount, stock, units sold, rating and shipping - then re-run with details on the products you care about (paste their IDs into **productIds**).
- **Recurring monitoring:** combine [Schedules](https://docs.apify.com/platform/schedules) with **monitorMode**; use a distinct **monitorKey** per keyword or product list.
- **Vetting a product:** add its URL or ID, turn on **includeReviews** and pick **reviewStars** 1 and 2 to read only the critical reviews.

### FAQ

**Do I need a Banggood API key or login?** No. The actor reads publicly available pages and the data feeds those pages load - no key, no login, no browser.

**Why does `price` differ from the price on Banggood's search page?** Banggood's search results show a first-order "New User" price. `price` is the regular price on the product page; the new-user figure is in `newUserPrice`.

**Can I get prices for my country?** Yes - set **shipToCountry** (196 countries) and **currency** (49 currencies). Every row says which country its prices and shipping are for.

**Can I scrape a whole category?** Yes - paste the category URL (`…-c-<id>.html`) into **startUrls**.

**How do I monitor price drops?** Turn on **monitorMode**, set a **monitorKey**, and create a [Schedule](https://docs.apify.com/platform/schedules). Each run delivers only products that are new or whose price or stock changed, tagged with `changeType` and the previous price.

**Does monitor mode conflict with Apify Schedules?** No - they complement each other. The Schedule starts the run on your cadence; monitor mode compares with previous runs so you only pay for new or changed products.

**Can I export to Google Sheets, CSV, or Excel?** Yes - one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).

**A field is null - why?** The product genuinely does not publish it (no discount, a single option, no brand tag, no reviews yet). See **Good to know**.

**Is scraping Banggood legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws and Banggood's terms.

### Disclaimer

**This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Banggood or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.**

"Banggood" and any related marks are the property of their respective owners and are used here only in a descriptive, nominative sense - to identify the publicly accessible website from which this Actor collects data. This Actor is not an official Banggood product, is not authorised or certified by Banggood, and does not distribute Banggood software. It collects only publicly available information; you are responsible for ensuring your use of that data complies with applicable laws, regulations and the terms of the source website.

### Need help?

Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome - this actor is actively maintained.

# Actor input Schema

## `searchTerms` (type: `array`):

Keywords to search Banggood for, e.g. <code>drone</code>, <code>phone case</code>, <code>led strip</code>. Each keyword is its own product feed (60 products per page), in Banggood's own ranking. Leave empty if you only use URLs or product IDs.

## `startUrls` (type: `array`):

Banggood URLs: product pages (<code>…-p-\<id>.html</code>), search pages (<code>/search/\<kw>.html</code>, <code>/buy/\<kw>.html</code>), category pages (<code>…-c-\<id>.html</code>) or review pages (<code>…-reviews-p\<id>.html</code> - the product plus its buyer reviews). You can also link or upload a text file of URLs here.

## `urlsFromFile` (type: `string`):

Paste a list of Banggood URLs and/or product IDs (one per line), or paste ONE link to a .txt / .csv file or a Google Sheet that holds them.

## `productIds` (type: `array`):

Banggood product IDs (e.g. <code>1940642</code>) to fetch full product detail for directly. Product URLs work here too.

## `sort` (type: `string`):

How Banggood orders the keyword search results.

## `maxProducts` (type: `integer`):

Maximum number of product records across all searches, URLs and product IDs (shared fairly between several searches). In monitor mode it is the watch list: the first N products of each search are checked every run.

## `maxPagesPerSearch` (type: `integer`):

How many result pages to read per keyword or listing (60 products each).

## `shipToCountry` (type: `string`):

The country the buyer is in. Banggood prices, discounts, shipping costs and delivery dates, and the overseas warehouses it offers, all depend on it. Leave empty for the United States (or, when you pick a warehouse below, that warehouse's region).

## `currency` (type: `string`):

Currency for every price in the output, converted with Banggood's own exchange rates (the same figures its site shows). <code>priceUsd</code> always carries the US-dollar value too.

## `warehouse` (type: `string`):

Only products that ship from this Banggood warehouse. Overseas warehouses are offered only to buyers in their region (US warehouse: US/CA buyers, UK: UK buyers, CZ/PL: EU buyers) - picking one sets the ship-to country to its region unless you chose one. Banggood no longer runs an Australian warehouse.

## `minPrice` (type: `integer`):

Only products whose regular price (in the chosen currency) is at least this much.

## `maxPrice` (type: `integer`):

Only products whose regular price (in the chosen currency) is at most this much.

## `fourStarPlus` (type: `boolean`):

Only products with an average rating of 4.0 or higher (products with no reviews yet are left out).

## `includeProductDetails` (type: `boolean`):

Open every product page for the full record: description, specifications, all images, brand, SKU, category breadcrumb, wholesale prices, every shipping option, and the variant matrix with each option's own price and stock. Turn off for a faster, cheaper discovery run - those rows still carry the regular price, discount, stock, units sold, rating and default shipping.

## `includeReviews` (type: `boolean`):

Fetch buyer reviews for every product (rating, text in the reviewer's own words plus an English translation when there is one, reviewer country, photos, helpful votes, date) as separate review records.

## `maxReviewsPerProduct` (type: `integer`):

Maximum number of reviews per product when reviews are on.

## `reviewsSort` (type: `string`):

Newest reviews first, or Banggood's "Top reviews" order (its featured, mostly older reviews).

## `reviewStars` (type: `array`):

Leave empty for all reviews. Pick e.g. 1 and 2 stars to collect only critical reviews.

## `deduplicateProducts` (type: `boolean`):

Deliver each product once per run, even if several searches find it.

## `monitorMode` (type: `boolean`):

Remember products across runs and deliver only the ones that are new to the watch list or whose price or stock changed since the last run - each carries a <code>changeType</code> (new / price_drop / price_rise / restocked / out_of_stock) and the previous price. With reviews on, only reviews not delivered before are sent. Pair it with an Apify Schedule.

## `monitorKey` (type: `string`):

Names the monitor's memory, so you can run several independent monitors (e.g. one per keyword). Reuse the same key to keep tracking the same products.

## `maxConcurrency` (type: `integer`):

How many products are fetched in parallel.

## `proxyConfiguration` (type: `object`):

The default Apify proxy works for every Banggood page; if Banggood ever refuses it, the actor moves to residential addresses by itself. Change this only to use your own proxies.

## Actor input object example

```json
{
  "searchTerms": [
    "drone"
  ],
  "sort": "default",
  "maxProducts": 100,
  "maxPagesPerSearch": 10,
  "currency": "USD",
  "warehouse": "ANY",
  "fourStarPlus": false,
  "includeProductDetails": true,
  "includeReviews": false,
  "maxReviewsPerProduct": 20,
  "reviewsSort": "recent",
  "deduplicateProducts": true,
  "monitorMode": false,
  "monitorKey": "default",
  "maxConcurrency": 4,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped Banggood product records and optional buyer review records as JSON items in the default dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "drone"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/banggood-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["drone"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/banggood-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchTerms": [
    "drone"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call scrapesage/banggood-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapesage/banggood-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/BMgPXmaI6K3BJvarl/builds/nt9PctzleUZhrXpkR/openapi.json