dhgate.com APIdhgate.com ↗
Access DHgate product search, category browsing, bulk pricing tiers, seller ratings, customer reviews, and flash deals via 5 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/024e9def-2f3c-46b2-820b-7badc7341d2a/search_products?page=1&query=laptop+bag' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on DHgate. Returns paginated results with product names, prices, URLs, and seller information.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order. Accepted values: 'bestmatch', 'price_asc', 'price_desc', 'recent'. |
| queryrequired | string | Search keyword. |
| max_price | string | Maximum price filter in USD (numeric string). |
| min_price | string | Minimum price filter in USD (numeric string). |
{
"type": "object",
"fields": {
"total": "integer total number of results",
"products": "array of product objects with item_code, name, price, url, image, seller, supplier_id"
},
"sample": {
"data": {
"total": 50,
"products": [
{
"url": "https://www.dhgate.com/product/high-quality-designer-bag-laptop-bag-briefcase/1105851708.html",
"name": "High quality designer bag laptop bag briefcase men bag",
"image": "",
"price": "$177.20",
"seller": "nxyluxury",
"item_code": "1105851708",
"supplier_id": ""
}
]
},
"status": "success"
}
}About the dhgate.com API
The DHgate API provides 5 endpoints for querying DHgate.com's wholesale marketplace, covering product search, category browsing, full product details, customer reviews, and flash deals. The get_product_details endpoint alone returns 9 distinct data groups including bulk price tiers, color and size attributes, shipping options, and seller rating summaries — making it practical for building price comparison tools, supplier evaluation workflows, or procurement dashboards.
Search and Category Browsing
The search_products endpoint accepts a required query string plus optional filters for min_price, max_price, page, and sort (accepted values: bestmatch, price_asc, price_desc, recent). Each result object includes item_code, name, price, url, image, seller, and supplier_id. The get_category_products endpoint takes a category_id — for example '110' for Shoes & Accessories — and returns the same product shape without supplier_id. Both endpoints expose a total integer so you can implement accurate pagination.
Product Details and Pricing Tiers
get_product_details accepts an item_code obtainable from either search or category results and returns the most granular data the API exposes. The price_tiers array contains bulk pricing levels keyed by minimum quantity, which is essential for wholesale cost modeling. The attributes array covers color and size variants. The shipping array includes cost, estimated delivery time, and express type per method. The seller_rating object provides a review summary tied to the supplier_id, and specifications is a key-value map of product spec names to their values.
Reviews and Flash Deals
get_product_reviews takes an item_code and optional page parameter, returning a reviewList where each object contains reviewid, score, content, buyerNickname, country, createdDateText, and prodAttrs (the variant the buyer selected). The totalCount integer supports paginated retrieval across large review sets. The get_flash_deals endpoint requires no inputs and returns a data array of discounted items, each with price, original_price, discount_percent, and save_price — useful for monitoring limited-time promotions.
- Build a bulk price calculator by pulling
price_tiersfromget_product_detailsacross multiple suppliers. - Compare seller credibility by aggregating
seller_ratingobjects for a set ofsupplier_idvalues. - Track flash deal discount depths over time using
discount_percentandoriginal_pricefromget_flash_deals. - Populate a product catalog by category using
get_category_productswith a known DHgatecategory_id. - Analyze buyer sentiment by language or region using
countryandcontentfields fromget_product_reviews. - Filter keyword search results by price band using
min_priceandmax_priceinsearch_products. - Audit shipping cost and delivery time variation across a product's available methods using the
shippingarray.
| 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 DHgate have an official developer API?+
What does `get_product_details` return beyond a basic price?+
price_tiers (bulk quantity-to-price mappings), a shipping array with per-method cost and delivery estimates, attributes for color and size variants, specifications as a key-value map of product properties, seller_rating summarizing the seller's review record, and an images array of product photo URLs.Can I retrieve seller profile pages or store-level inventory through this API?+
seller, supplier_id, and seller_rating as fields on product and detail objects, but there is no dedicated seller-profile or store-catalog endpoint. You can fork the API on Parse and revise it to add a seller-specific endpoint using the supplier_id values already returned.Are product variant-level stock quantities available?+
attributes array in get_product_details covers color and size options, but no stock count or inventory level field is exposed. You can fork the API on Parse and revise it to surface stock data if that field is available on the product page.How does pagination work across the search and category endpoints?+
search_products and get_category_products accept an integer page parameter and return a total integer in the response. You can calculate the number of pages by dividing total by the implicit page size and increment page accordingly. DHgate's category and search result sets can span many pages for broad queries, so filtering with min_price/max_price or a specific category_id helps narrow result volume.