# Banggood Scraper (`natanielsantos/banggood-scraper`) Actor

Easily scrape Banggood's product data. You can use it to extract name, prices, images, description, and more

- **URL**: https://apify.com/natanielsantos/banggood-scraper.md
- **Developed by:** [Nataniel Santos](https://apify.com/natanielsantos) (community)
- **Categories:** E-commerce, Developer tools, Automation
- **Stats:** 8 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### 🔍 What does Banggood Scraper do?

## The **Banggood Scraper** is a tool that allows you to easily extract detailed product data from Banggood.com

### ✨ What Does This Tool Do?

- 📊 Scrape using product URLs, category URLs or search results URLs
- 🌐 Supports multiple languages and currencies
- ⚡ Fast and reliable scraping
- 🧑‍💻 Perfect for non-technical users
- 🔒 No need for authentication
- 🔄 Automatically handles retries for failed requests
- 📦 Outputs data in JSON format for easy integration with other tools

***

### 🎯 Who Is This For?

- Market research and competitor analysis
- Academic research on e-commerce trends
- Data collection for business intelligence
- Building datasets for machine learning models
- Price comparison websites
  \--

### ⬇️ What You Need to Provide

- 🔗 **Product URLs** or **Category URLs**, **Search Results URLs** or **Share URLs** from Banggood
- 🔢 **Maximum Number of Items per URL**
- 🌍 **Shipping Destination** (Country Code)
- 💱 **Currency** for prices
- 🌐 **Language**

***

💡 Tip: You can add filters (min and max prices, sort, brand etc.) on Banggood's website and copy the URL

### 💡 Example Input

The scraper accepts the following input parameters:

```json
{
  "urls": [
    "https://usa.banggood.com/search/car.html?activity_product=1636&pto=500&page=1"
  ],
  "maxItems": 100,
  "currency": "USD",
  "shippingTo": "US"
}
```

For more details on input parameters, please refer to the [input schema](https://apify.com/natanielsantos/banggood-scraper/input-schema).

***

### 📦 What You’ll Get (Output)

Each product result includes:

- **🛒 Product Info** - product ID, name, variants, brand, categories
- **💰 Pricing** - market price, final price, discount percentage
- **📦 Stock Info** - stock availability for each variant
- **⭐ Reviews** - review count and average rating
- **🏷️ Product Attributes** - detailed attributes for each variant
- **🖼️ Images** - main image and additional images
- **📄 Description** - full product description
- **📈 Sales Data** - total units sold

***

### 📥 Output Example

```json
{
    "url": "https://usa.banggood.com/JJRC-Q117A-B-2_4G-4WD-High-Speed-RC-Car-1-16-Brushless-Motor-RC-Racing-Car-Climbing-Car-Drift-Off-Road-Vehicle-Gift-Toy-70-KM-or-h-p-1988427.html",
    "id": "1983205",
    "name": "Diatone SNT Y60 3005 1/64 2.4G 4WD RTR Carro RC Micro Luzes LED Patrulha Off-Road Óculos Opcionais Modelos de Veículos Mini Drift Escalada Caminhões Brinquedos",
    "category": "Brinquedos Hobbies e Robô -> Veículos RC -> carro rc",
    "brand": "DIATONE",
    "totalSold": 181,
    "warehouse": "CN",
    "reviewCount": 15,
    "rating": 4.47,
    "isDropship": false,
    "wishlistAmount": 801,
    "images": [
        "https://imgaz1.staticbg.com/thumb/large/oaupload/banggood/images/46/B4/1a6ff15f-abae-48df-9572-82d1f70dc180.jpg.webp",
        "https://imgaz2.staticbg.com/thumb/large/oaupload/banggood/images/DC/1E/f6370bcd-b397-4f10-8cb7-8fa85644b698.jpg.webp",
        "https://imgaz.staticbg.com/thumb/large/oaupload/banggood/images/67/FC/331f316f-406e-4bf2-b5e7-f556e23ec910.jpg.webp",
        "https://imgaz3.staticbg.com/thumb/large/oaupload/banggood/images/B5/66/5dfcb5a9-1250-4071-a057-4fe766251dfc.jpg.webp",
        "https://imgaz3.staticbg.com/thumb/large/oaupload/banggood/images/9B/46/88fdceef-d064-4407-bfcf-a7dad95bfecd.jpg.webp",
        "https://imgaz2.staticbg.com/thumb/large/oaupload/banggood/images/8D/25/0b4bac70-4c7a-4728-8678-2a290d4e19b2.jpg.webp"
    ],
    "mainImage": "https://imgaz1.staticbg.com/thumb/large/oaupload/banggood/images/46/B4/1a6ff15f-abae-48df-9572-82d1f70dc180.jpg.webp",
    "description": "Descrição:\n\n\nInformações básicas\n\nMarca: Diatone\n\nNúmero do modelo: SNT Y60 3005\nEscala:1/64\nCor:Vermelho,camuflagem\n\nSistema de energiaMotor: Motor escovadoTransmissor\n\nFrequência: 2.4G(AIR 5)\n\n\nCanal: 5CH\nDistância remota: 20 metros (locais abertos e sem interferências)\nBateria necessária: 3X bateria AAA (não incluída)\n\nPotência de transmissão: ≤25mW\n\n\nBateriaBateria para o carro: bateria de 3.7V de íon de lítio (incluída)\nTempo de carga: cerca de 30 minutos\nTempo de reprodução da bateria: Aproximadamente 30 minutos\n\nOutros\n\nPeso do controle remoto: 135 g\n\nAcelerador proporcional e direção\n\nFarol principal:Branco Luz de freio:Laranja Luz de ré:Vermelho Sinal de\nviragem:Amarelo Luz ambiente:Cor Caixa de câmbio:Câmbio coaxial Tipo de\nsuspensão:Suspensão não independente Potência VTX:4V de saída Potência extra de\nLED:Tensão da bateria\n\nDimensão\n\nTamanho do carro: 52*37*57mm\n\nDistância entre eixos: 41 mm\n\nEspaçamento das rodas: 28mm\n\nPneu dianteiro/traseiro: 14*3.5 KM3 R9.5mm\n\nAltura livre do solo mínima: 3 mm\n\nTamanho do controle remoto: 106*92*138mm\n\nVolante remoto: 56mm\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nRecursos:\n\nO primeiro veículo remoto mini off-road 4wd 1/64 O veículo remoto mini leva você\na experimentar a primeira visão Câmera de efeito magnético fácil e rápida de\ndesmontar Posição de sucção magnética dianteira e traseira dois modos de\nexperiência para um carro FPVBOX corrida,câmera de nível de competição,lente\ngrande angular de 130° 2,5 mm Óculos fpv HD imersivos,entre em um mundo real\nvirtual Com AIR5 controle remoto dedicado multifuncional,operação eficiente\nfeedback rápido,nova definição de empunhadura vertical Simulação de pneu BLC KM3\n14x3.5mm Contrapeso da roda 100% cobre ângulo de escalada off-road melhorado\nCarregamento rápido e conveniente,bateria duradoura\n\n\n\n\nPacote incluído:\n\n1X Y60 3005 Micro Carro (bateria embutida)\n\n1X Controle Remoto AIR5\n\n\n\n\n\n",
    "categories": [
        {
            "id": "133",
            "name": "Toys Hobbies and Robot",
            "url": "/Wholesale-Toys-Hobbies-and-Robot-c-133.html"
        },
        {
            "id": "8769",
            "name": "RC Vehicles",
            "url": "/Wholesale-RC-Vehicles-c-8769.html"
        },
        {
            "id": "1753",
            "name": "RC Car",
            "url": "/Wholesale-RC-Car-c-1753.html"
        }
    ],
    "variants": [
        {
            "poa": "POA10518552",
            "marketPriceUsd": 163.71,
            "marketPrice": 883.9,
            "finalPriceUsd": 136.43,
            "finalPrice": 736.79,
            "discountPercent": 17,
            "stock": 2,
            "attributes": [
                {
                    "valueId": "325526",
                    "valueName": "Red RTR Version",
                    "attributeName": "Color",
                    "attributeId": "2577"
                }
            ],
            "image": "https://imgaz2.staticbg.com/thumb/large/oaupload/banggood/images/BE/AF/db6d7223-02d6-4246-bafa-e0d421df29d3.jpg.webp"
        },
        {
            "poa": "POA11553048",
            "marketPriceUsd": 136.43,
            "marketPrice": 736.79,
            "finalPriceUsd": 136.43,
            "finalPrice": 736.79,
            "discountPercent": 0,
            "stock": 0,
            "attributes": [
                {
                    "valueId": "332691",
                    "valueName": "Camouflages RTR Version",
                    "attributeName": "Color",
                    "attributeId": "2577"
                }
            ],
            "image": "https://imgaz1.staticbg.com/thumb/large/oaupload/banggood/images/B7/98/392be228-397d-4e0f-81e8-4fa9f823b9d6.jpg.webp"
        }
    ]
}
```

***

### 🧩 Integrations and Banggood Profile Scraper

This scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, [and more](https://docs.apify.com/integrations). Or you can use [webhooks](https://docs.apify.com/integrations/webhooks) to carry out an action whenever an event occurs, e.g. get a notification whenever Banggood Profile Scraper successfully finishes a run.

***

### 🔌 Using Banggood Profile Scraper with the Apify API

The Apify API gives you programmatic access to the Apify platform. The API is organized around RESTful HTTP endpoints that enable you to manage, schedule, and run Apify actors. The API also lets you access any datasets, monitor actor performance, fetch results, create and update versions, and more.

To access the API using Node.js, use the apify-client NPM package. To access the API using Python, use the apify-client PyPI package.

Check out the [Apify API reference](https://docs.apify.com/api/v2) docs for full details.

***

### 💬 Giving feedback

If you have any feature requests or bug reports, please create an issue on the [Issues page](https://apify.com/natanielsantos/banggood-scraper/issues) or contact me directly via email.

If you need a custom solution of this actor, reach out to me through my email: nathan.santos159@hotmail.com

# Actor input Schema

## `urls` (type: `array`):

URLs to start with. It can be product, category, search or share URLs from Banggood.

## `maxItems` (type: `integer`):

Maximum number of items to scrape per URL. Set to 0 to scrape all items.

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

Select the currency for prices

## `shippingTo` (type: `string`):

Country code for shipping destination (e.g., US, BR).

## `language` (type: `string`):

Select your language

## Actor input object example

```json
{
  "urls": [
    "https://www.banggood.com/pt/BR-Direct-ABIR-X6-Robot-Vacuum-Cleaner-with-Camera-Navigation-Smart-Memory-Vacuum-Cleaner-Robot-WIFI-APP-Controlled,Breakpoint-Continue-Cleaning,DraCleaning-Area,Save-Map-p-2038915.html?rmmds=NewArrivalRecommendation&cur_warehouse=BR&ID=47184"
  ],
  "maxItems": 100,
  "currency": "USD",
  "shippingTo": "US",
  "language": "en-GB"
}
```

# 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 = {
    "urls": [
        "https://www.banggood.com/pt/BR-Direct-ABIR-X6-Robot-Vacuum-Cleaner-with-Camera-Navigation-Smart-Memory-Vacuum-Cleaner-Robot-WIFI-APP-Controlled,Breakpoint-Continue-Cleaning,DraCleaning-Area,Save-Map-p-2038915.html?rmmds=NewArrivalRecommendation&cur_warehouse=BR&ID=47184"
    ],
    "maxItems": 100,
    "currency": "USD"
};

// Run the Actor and wait for it to finish
const run = await client.actor("natanielsantos/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 = {
    "urls": ["https://www.banggood.com/pt/BR-Direct-ABIR-X6-Robot-Vacuum-Cleaner-with-Camera-Navigation-Smart-Memory-Vacuum-Cleaner-Robot-WIFI-APP-Controlled,Breakpoint-Continue-Cleaning,DraCleaning-Area,Save-Map-p-2038915.html?rmmds=NewArrivalRecommendation&cur_warehouse=BR&ID=47184"],
    "maxItems": 100,
    "currency": "USD",
}

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

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

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

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.banggood.com/pt/BR-Direct-ABIR-X6-Robot-Vacuum-Cleaner-with-Camera-Navigation-Smart-Memory-Vacuum-Cleaner-Robot-WIFI-APP-Controlled,Breakpoint-Continue-Cleaning,DraCleaning-Area,Save-Map-p-2038915.html?rmmds=NewArrivalRecommendation&cur_warehouse=BR&ID=47184"
  ],
  "maxItems": 100,
  "currency": "USD"
}' |
apify call natanielsantos/banggood-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=natanielsantos/banggood-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/bC8ixX8Ng9rINZeO4/builds/O1hwIEREafOug4F57/openapi.json