# DHgate Search Scraper (`xtracto/dhgate-search-scraper`) Actor Search DHgate.com for any keyword and get wholesale product cards with price, minimum order, seller, ratings, and recent sales. - **URL**: https://apify.com/xtracto/dhgate-search-scraper.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $20.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## DHgate Search Scraper Search [DHgate.com](https://www.dhgate.com/) for any keyword and get clean wholesale product cards — product, price, minimum order, seller, ratings, reviews, and recent sales — as structured JSON. ### Why use this actor - **Wholesale sourcing at scale** — every result links the product to its detail page and the seller's store. - **Real wholesale pricing** — captures the price (single value or range), the original pre-discount price, and the minimum order quantity for each product. - **Buyer trust signals** — seller feedback percentage, review rating, review count, positive-review percentage, and recent sales count when shown. - **No account, no API key** — works straight from public search pages. - **Automatic retries** — transient hiccups are retried for you, so runs stay reliable. - **Stable JSON output** — the same field names every run, ready for spreadsheets, databases, or pipelines. ### How it works 1. You provide one or more search keywords. 2. The actor pulls the search results for each keyword across as many pages as you allow (about 48 products per page). 3. Each product is saved as a `PRODUCT` record with its price, minimum order, seller, ratings, and recent sales. 4. If a keyword returns nothing, the actor still writes one diagnostic record so a query is never silently dropped. 5. Everything lands in your dataset, exportable as JSON, CSV, or Excel. You don't need to manage any browsers or scrapers. For larger runs we recommend enabling a proxy. ### Input ```json { "queries": [ "mechanical watch", "wireless earbuds" ], "maxPagesPerQuery": 2, "maxConcurrency": 4, "maxRequestRetries": 5, "proxyConfiguration": { "useApifyProxy": true } } ```` Each keyword in `queries` is searched independently and produces its own set of `PRODUCT` records. | Field | Type | Description | | --- | --- | --- | | `queries` | array | **Required.** Keywords to search (one per array entry). Each keyword yields its own product cards. | | `maxPagesPerQuery` | integer | Pages of results per query, ~48 products/page (`1`–`20`). Stops early when a page returns no more products. Default `2`. | | `maxConcurrency` | integer | Number of parallel requests across all keywords (`1`–`20`). Default `4`. | | `maxRequestRetries` | integer | Retries per page before giving up (`1`–`15`). Default `5`. | | `proxyConfiguration` | object | Apify Proxy or a custom proxy list. Datacenter proxies work fine for this source. | ### Output Each product is one record (`recordType: "PRODUCT"`): ```json { "recordType": "PRODUCT", "query": "mechanical watch", "page": 1, "title": "St9 Jacob Watch Ceramic Bezel Black Sapphire Date Dial 41Mm Automatic Mechanical Stainless Steel Mens Men Jacobo Co Wristwatches 4Ca", "productUrl": "https://www.dhgate.com/product/st9-jacob-watch-ceramic-bezel-black-sapphire/1106196355.html", "itemCode": "1106196355", "productId": "8aaafce29e15efcf019e2ab8ace940f4", "priceText": "US $29.47 - 42.12", "priceMin": 29.47, "priceMax": 42.12, "currency": "USD", "originalPriceText": "US $36.38 - 52.00 / Piece", "minOrder": "1 Piece", "minOrderNum": 1, "unit": "Piece", "image": "https://img4.dhresource.com/webp/m/300x300/f3/albu/bw/m/14/2ae1b0e0-7b90-4939-82c5-8c54fb7c59e3.jpg", "sellerName": "luxury_jewelry_top1", "storeUrl": "https://www.dhgate.com/store/top-selling/22273705.html", "sellerId": "8aaafdb89a4881da019a58638dd314a4", "feedbackPercent": "87.2%", "rating": 5.0, "reviewCount": 2, "positiveReview": "100%", "soldCount": 18, "freeShipping": false, "scrapedAt": "2026-06-10T19:24:27Z" } ``` If a keyword returns no products, the actor writes a single diagnostic record instead: ```json { "recordType": "PRODUCT", "_input": "xyzzy no such product", "error": "NO_RESULTS", "scrapedAt": "2026-06-10T19:24:27Z" } ``` | Field | Type | Description | | --- | --- | --- | | `recordType` | string | Always `"PRODUCT"`. | | `query` | string | The keyword that produced this record. | | `page` | integer | Result page the product was found on. | | `title` | string | Product title. | | `productUrl` | string | Full product detail URL. | | `itemCode` | string | DHgate product item code. | | `productId` | string | Internal product identifier. | | `priceText` | string | Price exactly as shown, e.g. `US $29.47 - 42.12`. | | `priceMin` / `priceMax` | number | Low / high end of the price (`priceMax` is `null` for a single price). | | `currency` | string | ISO currency of the price (e.g. `USD`). | | `originalPriceText` | string | Original pre-discount price when shown. | | `minOrder` | string | Minimum order quantity as shown, e.g. `1 Piece`. | | `minOrderNum` | integer | Minimum order quantity as a number. | | `unit` | string | Order unit, e.g. `Piece`. | | `image` | string | Primary product image URL. | | `sellerName` | string | Seller store handle. | | `storeUrl` | string | Seller's store page URL. | | `sellerId` | string | Internal seller identifier. | | `feedbackPercent` | string | Seller positive-feedback percentage, e.g. `87.2%`. | | `rating` | number | Product review rating when shown, e.g. `5.0`. | | `reviewCount` | integer | Number of product reviews when shown. | | `positiveReview` | string | Positive-review percentage when shown, e.g. `100%`. | | `soldCount` | integer | Recently sold count when shown. | | `freeShipping` | boolean | Whether the product is shown as free shipping. | | `scrapedAt` | string | ISO 8601 timestamp of collection. | | `error` | string | Only on diagnostic records: `NO_RESULTS` or `BLOCKED_AFTER_RETRIES`. | ### Other DHgate / Wholesale Scrapers | Actor | Description | | --- | --- | | [DHgate Search Scraper](https://apify.com/dhgate-search-scraper) | Keyword search → product cards with price, minimum order, seller, and ratings. | | [DHgate Product Scraper](https://apify.com/dhgate-product-scraper) | Full product detail: specifications, variants, shipping, and seller profile. | | [DHgate Reviews Scraper](https://apify.com/dhgate-reviews-scraper) | All buyer reviews for a product, with rating, text, and date. | # Actor input Schema ## `queries` (type: `array`): Keywords to search on DHgate.com (one per array entry). Each keyword is searched independently and yields its own product cards. ## `maxPagesPerQuery` (type: `integer`): How many pages of search results to traverse per query (about 48 products per page). The actor stops early once a page returns no more products. ## `maxConcurrency` (type: `integer`): Maximum number of parallel requests across all keywords. ## `maxRequestRetries` (type: `integer`): How many times a page request will be retried before giving up on that page. ## `proxyConfiguration` (type: `object`): Apify Proxy or your own proxy list. Datacenter proxies work fine for this source. ## Actor input object example ```json { "queries": [ "mechanical watch" ], "maxPagesPerQuery": 2, "maxConcurrency": 4, "maxRequestRetries": 5, "proxyConfiguration": { "useApifyProxy": true } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "queries": [ "mechanical watch" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/dhgate-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "queries": ["mechanical watch"], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("xtracto/dhgate-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "mechanical watch" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call xtracto/dhgate-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/dhgate-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "DHgate Search Scraper", "description": "Search DHgate.com for any keyword and get wholesale product cards with price, minimum order, seller, ratings, and recent sales.", "version": "1.0", "x-build-id": "gFt6k7Tg0rleIG5v4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~dhgate-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-dhgate-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/xtracto~dhgate-search-scraper/runs": { "post": { "operationId": "runs-sync-xtracto-dhgate-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/xtracto~dhgate-search-scraper/run-sync": { "post": { "operationId": "run-sync-xtracto-dhgate-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "queries" ], "properties": { "queries": { "title": "Search keywords", "type": "array", "description": "Keywords to search on DHgate.com (one per array entry). Each keyword is searched independently and yields its own product cards.", "items": { "type": "string" } }, "maxPagesPerQuery": { "title": "Max pages per query", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pages of search results to traverse per query (about 48 products per page). The actor stops early once a page returns no more products.", "default": 2 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of parallel requests across all keywords.", "default": 4 }, "maxRequestRetries": { "title": "Max retries", "minimum": 1, "maximum": 15, "type": "integer", "description": "How many times a page request will be retried before giving up on that page.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy or your own proxy list. Datacenter proxies work fine for this source." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```