{ "openapi": "3.0.1", "info": { "title": "Taobao & Tmall Scraper - $1.50 / 1000 Products", "description": "Taobao and Tmall products as clean JSON: search by keyword (Chinese or English) or category, or read item pages by link or id. Price in yuan with local prices, shop and its service scores, rating split, latest review, category path and ship-from location. No login. $1.50 per 1000 products.", "version": "0.1", "x-build-id": "huwXkehpuE7NmtBgf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeunblocker~taobao-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeunblocker-taobao-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/scrapeunblocker~taobao-scraper/runs": { "post": { "operationId": "runs-sync-scrapeunblocker-taobao-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/scrapeunblocker~taobao-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeunblocker-taobao-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": { "searches": { "title": "Search keywords", "type": "array", "description": "Keywords to search on Taobao (one search each), in Chinese or English, e.g. '手机壳' or 'phone case'. Chinese keywords match far more listings. Each search returns the first page Taobao shows signed-out visitors: up to 20 products. When Taobao has no results page for a keyword, the closest keyword Taobao itself suggests is used and the items say so.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Taobao category ids (e.g. 50005050) or category links (https://www.taobao.com/list/category/50005050.htm). Each returns the category's top 20 best sellers. Leave empty to use only searches or product links.", "items": { "type": "string" } }, "productUrls": { "title": "Product links or ids", "type": "array", "description": "Taobao or Tmall item links (https://item.taobao.com/item.htm?id=..., https://detail.tmall.com/item.htm?id=..., world.taobao.com/item/.htm) or bare item ids. Each returns the item page: title, price, ship-from location, category path, rating split, latest review and the shop with its service scores. Leave empty to use only searches or categories.", "items": { "type": "string" } }, "sort": { "title": "Order of search results", "enum": [ "relevance", "sales", "price_asc", "price_desc" ], "type": "string", "description": "The order keyword searches are taken in, which decides which 20 products you get. Categories always come in best-seller order.", "default": "relevance" }, "priceMin": { "title": "Minimum price (yuan)", "minimum": 0, "type": "integer", "description": "Keyword searches only: only products at or above this price in yuan (CNY)." }, "priceMax": { "title": "Maximum price (yuan)", "minimum": 0, "type": "integer", "description": "Keyword searches only: only products at or below this price in yuan (CNY)." }, "concurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many searches, categories or product pages to fetch at the same time (1-5).", "default": 3 } } }, "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 } } } } } } } } } }