DHgate product search

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

Products on DHgate (dhgate.com, wholesale marketplace) for keywords or a category, with every filter and sort of the search page: category, price range, free shipping, on sale, top rated, VIP price, Buyers' Picks, free samples, customizable, 7-day return, single piece, US warehouse, maximum minimum order, brand and ship-to country. 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. facets lists categories (with sub-categories and counts), brands and attributes; related_searches the site's related keywords. 40 products a page (sponsored products come on top), up to the first 3,000 matches; total is the site's count. 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
q string Keywords, e.g. phone case, wedding dress. Optional with category. Example: phone case
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/search?q=phone+case" \
  -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)

{"q": "phone case","applied_filters": {},"total": 68946,"page": 1,"pages": 75,"count": 50,"next_page": 2,"facets": {"categories": [{"id": "105","name": "Cell Phones & Accessories","count": 58206,"children": [{"…": "4 fields"}]},{"id": "107","name": "Bags, Luggage & Accessories","count": 3766,"children": []},"… 13 more"],"brands": [{"id": "109105","name": "yuanchi","image": "https://www.dhresource.com/70x35/f3/brandsec/ys/l/12/05f5e297-9cdb-487e-9337-0a15df289e72.png"},{"id": "2801","name": "disney","image": "https://www.dhresource.com/70x35/f2/brandsec/g5/M01/9D/34/rBVaJFh8eR-AJnLmAAClu0xZ3Ok437.jpg"},"… 26 more"],"attributes": [{"name": "Compatible","values": [{"…": "3 fields"},{"…": "3 fields"},"… 39 more"]},{"name": "Function","values": [{"…": "3 fields"},{"…": "3 fields"},"… 8 more"]},"… 6 more"]},"related_searches": ["cross body phone case","lip gloss phone case","… 5 more"],"products": [{"id": "1109524997","title": "iPhone 17 Pro Max Case Cross Body Chain, 17 Pro 16 15 14 13 12 11 16 Plus Caviar Leather Luxury Phone Case with Chain and Card Holder Shockp…","url": "https://www.dhgate.com/product/iphone-17-pro-max-case-cross-body-chain-17/1109524997.html","image": "https://img4.dhresource.com/300x300/f3/albu/bw/y/08/5f889917-dfe2-4d58-9d95-56dc044f7ff0.jpg","price_text": "US $25.33 - 30.18","price_min": 25.33,"price_max": 30.18,"original_price_text": "US $36.19 - 43.12 / Piece","currency": "USD","unit": "Piece","min_order": "1 Piece","min_order_qty": 1,"discount_percent": 30,"promotion_ends": "2026-11-15 23:59:00","free_shipping": true,"seven_day_return": false,"us_warehouse": false,"rating": null,"reviews": null,"sold_text": null,"positive_feedback": "98.3%","sponsored": true,"category_id": "105005002","store": {"id": "22278808","name": "haoa001","url": "https://www.dhgate.com/store/22278808","supplier_id": "8aaa068a9a4883e4019a926cc32a2e79","level": "3"}},{"id": "1099545426","title": "Magnetic Mirror Stand Phone Case for iPhone 16 - Electroplated Edge with Diamonds","url": "https://www.dhgate.com/product/magnetic-mirror-stand-phone-case-for-iphone/1099545426.html","image": "https://img4.dhresource.com/300x300/f3/albu/bw/l/30/428a393d-f472-4f93-8b7e-04fcf00d71af.jpg","price_text": "US $4.11 - 5.09","price_min": 4.11,"price_max": 5.09,"original_price_text": "US $4.11 - 5.09 / Piece","currency": "USD","unit": "Piece","min_order": "20 Pieces","min_order_qty": 20,"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": true,"category_id": "105005002","store": {"id": "22306423","name": "cl202603","url": "https://www.dhgate.com/store/22306423","supplier_id": "8aaae25d9cbdbc24019ce4c340f3676c","level": "2"}},"… 48 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.