Banggood APIbanggood.com ↗
Search Banggood products, fetch detailed pricing and specs, and retrieve customer reviews via a clean REST API. 3 endpoints, structured JSON responses.
What is the Banggood 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.
curl -X GET 'https://api.parse.bot/scraper/3bc9eaf5-f465-42af-81f8-9c3cd2be5dc0/search_products?limit=5&query=wireless+earbuds' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text search over Banggood product listings by keyword. Returns one product object per result with product_id, title, url (canonical www product page, consumable by get_product_details and get_product_reviews), price (display string in USD, e.g. 'US$14.99') and image URL. Results follow the site's default 'popular' ordering. The scraper fetches 20 results per round trip and continues to further pages until limit items are collected or results end; limit is clamped to 100. A keyword with no matches returns an empty products array.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to return (clamped to 100; each 20 results cost one round trip). |
| queryrequired | string | The search term (e.g. '3d printer', 'wireless earbuds'). |
{
"type": "object",
"fields": {
"products": "array of product objects with product_id (string), title, url (www product page), price (display string, e.g. 'US$14.99'), and image (thumbnail URL)"
},
"sample": {
"data": {
"products": [
{
"url": "https://www.banggood.com/Original-Xiaomi-Mi-True-Wireless-Earbuds-Basic-2S-bluetooth-5_0-Earphone-Touch-Control-Gaming-Mode-Sport-Headset-with-Type-C-Charging-p-1809623.html",
"image": "https://imgaz3.staticbg.com/thumb/view/oaupload/banggood/images/35/53/3e060747-b060-4301-b80f-0fc061021a6b.jpg.webp",
"price": "US$14.99",
"title": "Original Xiaomi Mi True Wireless Earbuds Basic 2S bluetooth 5.0 Earphone Touch Control Gaming Mode Sport Headset with Type-C Charging",
"product_id": "1809623"
},
{
"url": "https://www.banggood.com/Lenovo-EA175-TWS-Earbuds-Wireless-bluetooth-Earphone-Deep-Bass-Dual-Mic-AI-Call-Noise-Cancelling-Low-Delay-Touch-Control-Semi-in-ear-Sports-Headphones-p-2046866.html",
"image": "https://imgaz.staticbg.com/thumb/view/oaupload/banggood/images/F5/0C/bf9ed536-7627-4775-8ab4-7224f102f3be.jpg.webp",
"price": "US$13.99",
"title": "Lenovo EA175 TWS Earbuds Wireless bluetooth Earphone Deep Bass Dual Mic AI Call Noise Cancelling Low Delay Touch Control Semi-in-ear Sports Headphones",
"product_id": "2046866"
}
]
},
"status": "success"
}
}About the Banggood API
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.
The Banggood API is a managed, monitored endpoint for banggood.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when banggood.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official banggood.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. 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.