{ "openapi": "3.0.1", "info": { "title": "JD.com 京东 Jingdong Scraper - Prices & Reviews", "description": "Extract JD.com 京东 (Jingdong) product prices, images, shop data, attributes, and reviews by keyword. Supports Chinese searches like 苹果手机, 笔记本电脑, 机械键盘 plus Jingdong/Jindong queries. Export JSON, CSV, Excel.", "version": "0.0", "x-build-id": "6o183nrSLpaKqDfnV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~jd-com-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-jd-com-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/zen-studio~jd-com-search-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-jd-com-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/zen-studio~jd-com-search-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-jd-com-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": [ "keyword" ], "properties": { "keyword": { "title": "关键词 Keyword", "type": "string", "description": "Enter a JD.com / 京东 product search keyword.

Examples:
• iphone 15
• 苹果手机 iPhone / Apple phones
• 笔记本电脑 laptops
• 机械键盘 mechanical keyboards" }, "maxItems": { "title": "商品数量 Max products", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Set the maximum number of product rows to return. The default is 20 products. Test runs are capped at 5 products. Free-tier runs are capped at 20 products.", "default": 20 }, "enrichWithDetails": { "title": "商品详情 Detail enrichment (default on)", "type": "boolean", "description": "Keep enabled to add rich 商品详情 data: attributes, configured items, delivery costs, promotions, related groups, vendor data, category path, weight data, media, and included provider reviews when returned.

Included provider reviews from the detail response are returned for free. Turn this off only when you want cheaper search-only rows.", "default": true }, "sort": { "title": "排序 Sort", "enum": [ "relevance", "popularity", "lowest_price", "highest_price", "recently_updated" ], "type": "string", "description": "Choose how matching products are ordered. Relevance leaves the marketplace default sorting unchanged. Recently updated uses marketplace update recency and applies client-side keyword filtering because source-side recent sorting can otherwise return loose matches. It may return fewer rows when weak matches are filtered out.", "default": "relevance" }, "category": { "title": "分类 Category", "enum": [ "all", "mobile_phones", "phone_cases", "second_hand_phones", "quasi_new_phones", "laptops", "laptop_accessories", "keyboards", "running_shoes" ], "type": "string", "description": "Choose an optional tested JD.com category slug. Leave All categories for the broadest results.

Category filtering narrows JD's marketplace taxonomy, but sellers and listings can still be imperfectly categorized. The actor filters weak keyword matches before detail enrichment, so category runs may return fewer rows than Max products.", "default": "all" }, "minPrice": { "title": "最低价 Min price (USD)", "minimum": 0, "type": "number", "description": "Optional minimum converted USD price. Leave blank for no lower price filter." }, "maxPrice": { "title": "最高价 Max price (USD)", "minimum": 0, "type": "number", "description": "Optional maximum converted USD price. Leave blank for no upper price filter." }, "fetchReviews": { "title": "买家评价 Customer reviews", "type": "boolean", "description": "Fetch separate customer review pages and attach reviews as a nested reviews array. Reviews are billed separately. Keep off unless review text is needed.

To fetch all available reviews up to the Actor limit, enable this and set 每商品评价数 Reviews per product to 1000.", "default": false }, "maxReviewsPerItem": { "title": "每商品评价数 Reviews per product", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Set the maximum reviews to attach to each product when 买家评价 Customer reviews is enabled.

Use 1000 when you want all available reviews up to the Actor limit. The actor stops earlier if the source reports fewer reviews.", "default": 20 } } }, "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 } } } } } } } } } }