banggood.com APIbanggood.com ↗
Search Banggood products, fetch detailed pricing and specs, and retrieve customer reviews via a clean REST API. 3 endpoints, structured JSON responses.
curl -X GET 'https://api.parse.bot/scraper/3bc9eaf5-f465-42af-81f8-9c3cd2be5dc0/search_products?limit=5&query=3d+printer' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Banggood by keyword. Returns a list of matching products with basic info. Prices may not be available in search results for all products.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to return. |
| queryrequired | string | The search term (e.g. '3d printer', 'wireless earbuds'). |
{
"type": "object",
"fields": {
"products": "array of product objects with product_id, title, url, price, and image"
},
"sample": {
"data": {
"products": [
{
"url": "https://www.banggood.com/EU-or-US-DirectTRONXY-Moore-2-Pro-...-p-1983471.html?cur_warehouse=USA&ID=47757&rmmds=search",
"image": "https://imgaz1.staticbg.com/thumb/gallery/oaupload/banggood/images/21/19/63712c4d-85d0-4303-a89b-24948fbb9a6c.jpg.webp",
"price": "",
"title": "[EU/US Direct]TRONXY Moore 2 Pro Ceramic Clay 3D Printer...",
"product_id": "1983471"
}
]
},
"status": "success"
}
}About the banggood.com API
The Banggood API provides 3 endpoints for accessing product data from banggood.com: search by keyword with search_products, retrieve full product details — including price, rating, images, and breadcrumb categories — with get_product_details, and pull customer review text and star ratings with get_product_reviews. Each endpoint returns structured JSON and accepts a Banggood product ID as the primary identifier.
Endpoints and What They Return
The search_products endpoint accepts a query string (e.g. '3d printer', 'wireless earbuds') and an optional limit integer. It returns an array of product objects, each containing product_id, title, url, price, and image. Note that price may be null for some search results — use get_product_details to reliably retrieve pricing.
get_product_details takes a required product_id (numeric string) and an optional product_url. Supplying product_url is recommended for accuracy; without it the endpoint constructs a generic URL from the ID, which may resolve incorrectly. The response includes title, price, currency, description, rating (out of 5), review_count, images (array of URLs), categories (breadcrumb strings), and product_id.
Reviews
get_product_reviews returns an array of review objects under the reviews key, each with reviewer_name, review_date, review_text, and rating on a 0–5 scale. Like get_product_details, it accepts both product_id and an optional product_url — omitting the URL may cause the endpoint to fall back to a generic reviews page that doesn't resolve to the correct product.
Coverage Notes
All three endpoints return data for Banggood's international storefront. Product availability, pricing, and review content reflect what is publicly visible on banggood.com at the time of the request. The description field in product details is sourced from structured data on the product page and may be null if the product page does not include it.
- Track price changes on specific Banggood products by polling
get_product_detailsfor thepriceandcurrencyfields. - Build a product comparison tool using
search_productsto find candidates, thenget_product_detailsto compareratingandreview_count. - Aggregate customer sentiment by collecting
review_textandratingfields fromget_product_reviewsacross multiple products. - Populate a product catalog with Banggood listings using
title,images,categories, andpricefrom the details endpoint. - Monitor category breadcrumbs via the
categoriesarray to understand how Banggood classifies products over time. - Filter search results by keyword and limit to quickly identify top products in a niche for market research.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Banggood have an official developer API?+
When should I supply the `product_url` parameter to `get_product_details` or `get_product_reviews`?+
product_url when you have it. Without it, the endpoint constructs a URL from product_id alone, and that generic URL may not resolve to the correct product page. Passing the full URL ensures the response fields — including description, images, and categories — match the intended product.Why is `price` sometimes null in `search_products` results?+
get_product_details with the corresponding product_id to retrieve the price and currency fields reliably.Does the API cover variant-level data such as SKU options, color/size selections, or warehouse-specific stock?+
price, title, images, rating, categories, and description. Variant-level attributes like color, size, and warehouse stock are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting variant or SKU data.Is there pagination support for search results or reviews?+
search_products, use the limit parameter to control result count, but there is no page or offset parameter currently. For get_product_reviews, the endpoint returns what is available on the reviews page without paginated offsets. You can fork this API on Parse and revise it to add pagination parameters for deeper result sets.