{ "openapi": "3.0.1", "info": { "title": "DHgate Products Scraper & API - Wholesale Prices, MOQ, Sellers", "description": "DHgate products scraper and API: search DHgate.com wholesale products by keyword with price, MOQ, free-shipping, rating and sold filters. One result = one product: price range, discount %, MOQ, sold count, rating, seller and feedback %, image, URL. No login. $0.15 per 1,000, the cheapest.", "version": "1.0", "x-build-id": "OJYec2LgfCziE423V" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rel8ble~dhgate-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rel8ble-dhgate-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/rel8ble~dhgate-scraper/runs": { "post": { "operationId": "runs-sync-rel8ble-dhgate-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/rel8ble~dhgate-scraper/run-sync": { "post": { "operationId": "run-sync-rel8ble-dhgate-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", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Provide at least one. Product keywords to search on DHgate.com, e.g. [\"led light\", \"yoga mat\"], or DHgate search URLs (the keyword is read from them). One search per line. Default [\"led light\"] (demo only).", "default": [ "led light" ], "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 0, "type": "integer", "description": "Optional. Maximum unique products saved per keyword, integer >= 0. Default 100; 0 = as many as DHgate's category pages for the keyword hold (often several thousand). You pay per product, so use 10-20 for a quick answer.", "default": 100 }, "categories": { "title": "Categories", "type": "array", "description": "Optional. Limit the search to DHgate top-level categories, by name or URL, e.g. [\"Lights & Lighting\", \"Home & Garden\"] or [\"https://www.dhgate.com/wholesale/home-garden/c019.html\"]. Names: Apparel, Automobiles & Motorcycles, Baby, Kids & Maternity, Bags & Luggage, Cell Phones & Accessories, Computers & Networking, Electronics, Fashion Accessories, Games & Accessories, Hair Products, Health & Beauty, Home & Garden, Jewelry, Lights & Lighting, Office & School & Business & Industrial, Pet Supplies, Shoes & Accessories, Sports & Outdoors, Toys & Gifts, Watches, Wedding & Party Events. Omit for all categories.", "items": { "type": "string" } }, "minPrice": { "title": "Min unit price (USD)", "minimum": 0, "type": "integer", "description": "Optional. Minimum unit price in US dollars, integer >= 0. Products whose highest price is below it are skipped (not charged). Omit for no minimum." }, "maxPrice": { "title": "Max unit price (USD)", "minimum": 0, "type": "integer", "description": "Optional. Maximum unit price in US dollars, integer >= 0. Products whose lowest price is above it are skipped (not charged). Omit for no maximum." }, "maxMoq": { "title": "Max MOQ", "minimum": 1, "type": "integer", "description": "Optional. Only products whose minimum order is at or below this quantity, integer >= 1, e.g. 1 for single-unit orders. Omit for no limit." }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "Optional boolean. true = only products with free shipping. Default false.", "default": false }, "minRating": { "title": "Min product rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Optional. Minimum product rating 1-5 (products without reviews are skipped when set). Omit for any." }, "minSold": { "title": "Min sold count", "minimum": 1, "type": "integer", "description": "Optional. Only products DHgate shows as sold at least this many times (products without a sold count are skipped when set). Omit for any." }, "includeAds": { "title": "Include sponsored listings", "type": "boolean", "description": "Optional boolean. true = keep sponsored listings (flagged isAd: true). Default true.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Optional, advanced. Parallel requests, integer 1-10. Default 3. Leave unset.", "default": 3 }, "maxRequestRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 20, "type": "integer", "description": "Optional, advanced. Retries per failed or blocked request, integer 0-20; each retry uses a new proxy IP. Default 6.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional, advanced. Leave as is. Default {\"useApifyProxy\": false} = automatic: direct connection first, and only requests that get blocked are retried through Apify residential proxy. Set Apify Proxy groups or your own proxy URLs to force them for every request.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }