DHgate store products
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
| name | type | description |
|---|---|---|
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" import os, requests
res = requests.get(
"https://api.api.sh/dhgate/v1/store-products",
params={"id": "20750510"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/dhgate/v1/store-products");
url.searchParams.set("id", "20750510");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); 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}