{ "openapi": "3.0.1", "info": { "title": "Taobao Tmall Product Detail Scraper — SKUs", "description": "Scrape public Taobao and Tmall product details from item URLs or numeric IDs. Returns title, CNY price, shop, images, ratings, and SKU hints via cookieless world.taobao.com HTTP. Use the sibling search Actor for keyword listing cards.", "version": "0.2", "x-build-id": "QaqR8At78Y5X8LWu4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~taobao-product-detail-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-taobao-product-detail-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/khadinakbar~taobao-product-detail-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-taobao-product-detail-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/khadinakbar~taobao-product-detail-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-taobao-product-detail-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": { "productUrls": { "title": "Taobao and Tmall product page URLs", "maxItems": 50, "type": "array", "description": "Product page URLs to scrape, one per line. Accepted hosts include item.taobao.com, detail.tmall.com, world.taobao.com/item, and short links such as e.tb.cn. Example: https://item.taobao.com/item.htm?id=974671890820. Shop homepages and s.taobao.com search URLs are ignored.", "items": { "type": "string", "minLength": 8 }, "default": [] }, "itemIds": { "title": "Taobao and Tmall numeric item IDs", "maxItems": 50, "type": "array", "description": "Numeric item identifiers when you do not have a full URL. Enter digits only, for example 974671890820. Each ID is fetched from https://world.taobao.com/item/{id}.htm. This is not a shop seller ID or a search keyword.", "items": { "type": "string", "minLength": 5, "maxLength": 24 }, "default": [] }, "maxItems": { "title": "Maximum products for the run", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard cap on billed product-detail rows for this run. The Actor stops before the cap and checks again immediately before every paid dataset write. Prefill 1; default 10 costs at most $0.08 in product-detail events plus the $0.00005 start event. This does not raise HTTP concurrency.", "default": 10 }, "includeVariants": { "title": "Include SKU / variant hints", "type": "boolean", "description": "When true, collect public SKU property strings shown on world.taobao.com review snippets. Leave true for a richer parent record. Turn false for a smaller parent-level row. This does not unlock private inventory or member prices.", "default": true }, "maxConcurrency": { "title": "HTTP concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "How many item pages to fetch in parallel. Keep 1–3 for stability on world.taobao.com. Default and prefill are 2. This does not raise the maxItems billing cap.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy override. The Actor tries a direct world.taobao.com fetch first, then Residential. Prefer RESIDENTIAL when the direct hop is blocked. This does not change billed event prices.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }