{ "openapi": "3.0.1", "info": { "title": "Taobao 淘宝 & Tmall 天猫 Product Scraper - USD & Reviews", "description": "Scrape Taobao (淘宝) and Tmall (天猫) products from links, share links or item IDs. Get English titles, CNY and USD prices, shop details, seller ratings, buyer tags and sample reviews as clean JSON. Bulk input, live results, no account or cookies needed.", "version": "1.0", "x-build-id": "RpyYMN8zdEvqPAdAU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/insights_data~taobao-tmall-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-insights_data-taobao-tmall-product-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/insights_data~taobao-tmall-product-scraper/runs": { "post": { "operationId": "runs-sync-insights_data-taobao-tmall-product-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/insights_data~taobao-tmall-product-scraper/run-sync": { "post": { "operationId": "run-sync-insights_data-taobao-tmall-product-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": [ "urls" ], "properties": { "urls": { "title": "🛒 Taobao / Tmall products", "minItems": 1, "type": "array", "description": "One entry per line. Accepted: item.taobao.com or detail.tmall.com product links, short share links (e.tb.cn, m.tb.cn, s.click.taobao.com) and bare numeric item IDs. Mixed formats are fine and duplicates are skipped. Free plan: up to 10 products per run, with no monthly limit; paid plans have no limit.", "items": { "type": "string" } }, "language": { "title": "🌍 Output language", "type": "string", "description": "Language of the translated title, description and category path. English, Russian and Malay are built in; you can also type a full locale such as ja_JP. Choose original to get the Chinese text only.", "default": "en" }, "includeOriginalTitle": { "title": "🈶 Original Chinese title", "type": "boolean", "description": "Adds titleOriginal, the Chinese title, next to the translated title.", "default": true }, "includeDescription": { "title": "📝 Product description", "type": "boolean", "description": "Adds descriptionHtml, the translated description as HTML.", "default": true }, "includeDescriptionImages": { "title": "🌄 Description images", "type": "boolean", "description": "Adds descriptionImages, the list of images shown in the product description.", "default": true }, "includeCategoryPath": { "title": "📂 Category path", "type": "boolean", "description": "Adds categoryPath, the breadcrumb of categories the product belongs to.", "default": true }, "includeSellerRatings": { "title": "⭐ Seller ratings", "type": "boolean", "description": "Adds sellerRatings: store rating plus description, service and logistics scores.", "default": true }, "includeCoupon": { "title": "🎫 Coupon link", "type": "boolean", "description": "Adds couponUrl, the promotion link shown for the product when there is one.", "default": true }, "includeReviews": { "title": "💬 Sample reviews", "type": "boolean", "description": "Adds reviews, the sample buyer reviews shown for the product (rating, text, photos, video, follow-up comments), plus reviewsSampleCount and hasMoreReviews.", "default": true }, "includeReviewTags": { "title": "🏷️ Buyer impression tags", "type": "boolean", "description": "Adds reviewTags, the most common buyer impressions with how many buyers said them.", "default": true }, "includeAvailableLanguages": { "title": "🔤 Available languages", "type": "boolean", "description": "Adds availableLanguages, the translation languages offered for the product.", "default": false }, "maxRetries": { "title": "🔄 Retries per request", "minimum": 0, "maximum": 10, "type": "integer", "description": "How often a failed or blocked request is retried before giving up on that product (0 to 10). Also the number of fresh-IP tries on the last proxy step.", "default": 3 }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Optional. By default the actor connects without a proxy. If Taobao refuses the connection it switches to datacenter proxies, then residential proxies, and stays on that step for the rest of the run.", "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 } } } } } } } } } }