DHgate store products

GET https://api.api.sh/dhgate/v1/store-products
1 credit / call e-commerce try it in the playground →

Every product of a DHgate store, with the same filters and sorts as /dhgate/v1/search (price range, free shipping, on sale, sort by best selling, price or newest...). Each product: id (item code), title, url, image, price text and price_min/price_max in US dollars, original price, unit, minimum order, discount and promotion end, free shipping, 7-day return and US-warehouse flags, rating, review count, sold count text, positive feedback, sponsored, category id, the store (id, name, url, supplier id, level) and raw. 40 products a page. Pass next_page back as page; null on the last page.

Every response includes credits_used: the credits this call cost.

Part of the DHgate API: 7 endpoints with prices, use cases and example responses.

Parameters

nametypedescription
id string The store number (e.g. 20750510) or its link. Example: 20750510
supplier_id string Instead of id: store.supplier_id from search or product (skips one lookup).
category string Category id from facets.categories (e.g. 105005002 cell phone cases).
sort best_match | best_selling | price_asc | price_desc | newest | top_reviewed Order.
min_price number Lowest price in US dollars.
max_price number Highest price in US dollars.
free_shipping true true: only free shipping.
on_sale true true: only products on sale.
top_rated true true: only highly rated products.
vip_price true true: only products with a VIP price.
buyers_picks true true: only Buyers' Picks.
free_samples true true: only products with free samples.
customizable true true: only customizable products.
seven_day_return true true: only products with 7-day returns.
single_piece true true: only products sold by the single piece.
us_warehouse true true: only products shipped from a US warehouse.
max_min_order integer Only products whose minimum order is at most this quantity.
brand string Brand id from facets.brands.
ship_to string Two-letter destination country for shipping (default us), e.g. gb, de, au.
page integer Page number. Pass next_page from the previous response; null on the last page.

Every endpoint also takes fresh, raw, fields (see lean responses and caching).

Example

curl "https://api.api.sh/dhgate/v1/store-products?id=20750510" \
  -H "x-api-key: $APISH_KEY"

Response

A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).

Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)

{"store": "20750510","supplier_id": "ff8080815d2b7f6d015d698b6146376b","applied_filters": {},"total": 110,"page": 1,"pages": 3,"count": 40,"next_page": 2,"facets": {"categories": [{"id": null,"name": "Cell Phones & Accessories","count": 109,"children": []},{"id": null,"name": "Computers & Networking","count": 1,"children": []}],"brands": [],"attributes": []},"related_searches": [],"products": [{"id": "639697605","title": "USB C Hub Multiport Adapter 4-in-1 With 4K HDMI 2 USB 3.0 Ports 87W Power Delivery compatible for Laptops Macbook Pro Air","url": "https://www.dhgate.com/product/usb-c-hub-multiport-adapter-4-in-1-with-4k/639697605.html?d1_page_num=1","image": "https://www.dhresource.com/300x300/f2/albu/g17/M00/FB/83/rBVa4WAEGtqAB24aAALj_sNbJO8934.jpg","price_text": "US $38.86 - 51.64","price_min": 38.86,"price_max": 51.64,"original_price_text": "US $38.86 - 51.64 / Piece","currency": "USD","unit": "Piece","min_order": "10 Pieces","min_order_qty": 10,"discount_percent": null,"promotion_ends": null,"free_shipping": true,"seven_day_return": false,"us_warehouse": false,"rating": null,"reviews": null,"sold_text": null,"positive_feedback": "100.0%","sponsored": false,"category_id": "104005007","store": {"id": "20750510","name": "ocasen","url": "https://www.dhgate.com/store/20750510","supplier_id": "ff8080815d2b7f6d015d698b6146376b","level": "4"}},{"id": "621878861","title": "AG Matte Privacy Tempered Glass Screen Protector for iPhone 16 15 14 13 12 11 Pro Max XR XS Anti-Fingerprint Premium Quality no retail packi…","url": "https://www.dhgate.com/product/full-cover-privacy-tempered-glass-for-iphone/621878861.html?d1_page_num=1","image": "https://img4.dhresource.com/300x300/f3/albu/jc/j/17/ea127bed-6619-4131-9332-bcab296a1439.jpg","price_text": "US $39.27 - 45.66","price_min": 39.27,"price_max": 45.66,"original_price_text": "US $39.27 - 45.66 / Piece","currency": "USD","unit": "Piece","min_order": "100 Pieces","min_order_qty": 100,"discount_percent": null,"promotion_ends": null,"free_shipping": true,"seven_day_return": false,"us_warehouse": false,"rating": 5,"reviews": 7,"sold_text": "9","positive_feedback": "100%","sponsored": false,"category_id": "105005006","store": {"id": "20750510","name": "ocasen","url": "https://www.dhgate.com/store/20750510","supplier_id": "ff8080815d2b7f6d015d698b6146376b","level": "4"}},"… 38 more"],"cached": false,"credits_used": 1}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.