DHgate product
One DHgate product: title, url, category, price (min and max in US dollars, original prices, discount, promotion end, and the quantity tiers with their unit prices), unit, minimum and maximum order, lot size, sold count, package size and weight, full-size images, variants (colors, sizes, models with their images), stock, specifications, highlights, the seller's description (text and HTML), shipping to the US (method, cost, free, delivery days, estimated delivery, handling days), rating, review count and breakdown, review tags, and the store (id, name, url, supplier id, positive feedback, transactions, level, country, years, followers, product count, company details). latest=true with search params opens the first product of that search. Removed products answer 404.
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 product item code (id in search, e.g. 404047032) or its dhgate.com/product/... link. Example: 404047032 |
latest | true | true: the first (non-sponsored) product of a search with the same params (q, filters). |
q | string | With latest=true: the search keywords. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/dhgate/v1/product?id=404047032" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/dhgate/v1/product",
params={"id": "404047032"},
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/product");
url.searchParams.set("id", "404047032");
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)
{"id": "404047032","title": "Transparent Shockproof Acrylic Hybrid Armor Hard Phone Cases for iPhone 17 16 16E 15 14 13 12 11 Pro XS Max XR 8 7 6 Plus Samsung S25 S24 S2…","url": "https://www.dhgate.com/product/transparent-shockproof-acrylic-hybrid-armor/404047032.html","product_id": "ff8080815e044322015e2b94eca4265d","category": "Cell Phone Cases","category_id": "105005002","price": {"currency": "USD","min": 0.89,"max": 1.61,"original_min": 0.89,"original_max": 1.61,"discount_percent": null,"promotion_ends": null,"tiers": [{"min_qty": 100,"max_qty": 219,"price": 1.14,"original_price": 1.14,"discount_percent": 0},{"min_qty": 220,"max_qty": 549,"price": 1,"original_price": 1,"discount_percent": 0},"… 3 more"]},"unit": "Piece","unit_plural": "Pieces","min_order": 100,"lot_size": 1,"max_order": 10000,"sold": 0,"package": {"length_cm": 1,"width_cm": 10,"height_cm": 18,"weight_kg": 0.04},"images": ["https://img4.dhresource.com/webp/m/0x0/f3/albu/bw/g/12/bd6c2f6b-fc57-4188-8bd6-7b309d23ae0f.jpg","https://img4.dhresource.com/webp/m/0x0/f3/albu/km/s/18/3517f8dd-a280-4ca0-9bed-161e8115ac37.jpg","… 6 more"],"variants": [{"name": "Color","id": 985100,"values": [{"id": 1383851,"name": "Transparent","image": "https://www.dhresource.com/0x0/f2/albu/g22/M00/75/21/rBNaEmJeXPeALOGEAAJb1cIU-iQ666.jpg"}]},{"name": "Compatible","id": 700573,"values": [{"id": 2504671,"name": "for iPhone 15","image": null},{"id": 2504669,"name": "for iPhone 15 Pro","image": null},"… 33 more"]}],"stock": 10000,"specifications": [{"name": "Function","value": "Dirt-resistant Water Resistant"},{"name": "Type","value": "Fitted Case"},"… 3 more"],"highlights": ["Direct factory price, DHgate Professional Factory Shop! MOQ:10pcs a model. There are hundreds of models, please contact us if you need other…","Reinforced corners and raised bezel edges keep the screen or camera from the damage by dropping, bumping and scratching when placed face dow…","… 3 more"],"description": "Transparent Shockproof Acrylic Hybrid Armor Hard Phone Cases for iPhone 17 16 16E 15 14 13 12 11 Pro XS Max XR 8 7 6 Plus Samsung S25 S24 S2…","description_html": "<p class=\"processed-content\" style=\"width: 960px; margin: 0px auto; padding: 25px 20px 45px !important;\"><div class=\"related-produc-box\"><ul…","shipping": {"to": "US","from": "CN","method": "Fast Express Logistics","cost": 0,"free": true,"delivery_days_min": 1,"delivery_days_max": 10,"estimated_delivery": "Dec. 16 - Dec. 16","handling_days": 12,"can_deliver": true},"rating": 5,"reviews": 1482,"reviews_with_photos": 20,"transactions": 1691,"rating_breakdown": {"1": 0,"2": 1,"3": 7,"4": 20,"5": 1454},"review_tags": [{"name": "Satisfied","count": 93},{"name": "Excellent","count": 24},"… 46 more"],"store": {"id": "20750510","name": "ocasen","url": "https://www.dhgate.com/store/20750510","supplier_id": "ff8080815d2b7f6d015d698b6146376b","positive_feedback": "100.0%","transactions": 5529,"level": "LV4","country": "China","years": 6,"followers": 683,"products": 111,"company": {"name": "深圳市欧凯晟科技有限公司","established": "2009","employees": "51 - 100 People","main_categories": ["Cell Phones & Accessories","Cameras & Photo","… 3 more"]}},"cached": false,"credits_used": 1}