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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace banggood-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.banggood_product_api import Banggood, ProductSummary, Product, Review
client = Banggood()
# Search for wireless earbuds
for item in client.productsummaries.search(query="wireless earbuds"):
print(item.product_id, item.title, item.url)
# Get full details for a product summary
product = item.details()
print(product.price, product.currency, product.rating, product.review_count)
# List reviews for the product
for review in product.reviews.list():
print(review.reviewer_name, review.review_date, review.review_text, review.rating)
break
Full-text search over Banggood product listings by keyword. Returns basic product info including title, URL, and image. Prices may be empty for some products in search results. Single-page results; the limit param controls max items returned.
| 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/OnePlus-Buds-4-p-2035773.html?rmmds=search",
"image": "https://imgaz2.staticbg.com/thumb/gallery/oaupload/banggood/images/D5/E0/6ce67ca3-7b98-4727-8504-18fbb49273a5.jpg.webp",
"price": "",
"title": "OnePlus Buds 4 TWS ANC Earbuds Wireless bluetooth 5.4 Earphone",
"product_id": "2035773"
}
]
},
"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 | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 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.