{ "openapi": "3.0.1", "info": { "title": "Taobao Product Feed Scraper", "description": "Scrape the products Taobao recommends on its homepage feed. Each row has the product id, Chinese title, price in yuan, image, product link, SKU id, seller id, shop id and category ids. A feed, not a keyword search. No account needed. $1.95 per 1,000 products.", "version": "0.1", "x-build-id": "nlezbu10VKbvAGnpi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~taobao-product-feed-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-taobao-product-feed-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/dami_studio~taobao-product-feed-scraper/runs": { "post": { "operationId": "runs-sync-dami_studio-taobao-product-feed-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/dami_studio~taobao-product-feed-scraper/run-sync": { "post": { "operationId": "run-sync-dami_studio-taobao-product-feed-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": { "maxItems": { "title": "How many products to return", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Number of distinct Taobao products to collect (1-5000). You are charged once per product returned. There is no keyword input: this reads Taobao's own homepage recommendation feed, which reshuffles on every call, so a bigger number simply means a longer walk through it. Leave this empty and the run returns one free sample row instead of scraping anything." }, "minPriceCny": { "title": "Minimum price (CNY)", "minimum": 0, "type": "integer", "description": "Optional. Drop products cheaper than this many yuan. The feed has no price parameter, so this is applied after the fetch and dropped rows are never charged, expect the run to make more requests for the same number of results. While either price limit is set, products the feed shows no price for are dropped too, also free, and counted apart in the status line." }, "maxPriceCny": { "title": "Maximum price (CNY)", "minimum": 0, "type": "integer", "description": "Optional. Drop products more expensive than this many yuan. Measured across 1,021 distinct products (two 600-product runs, 2026-08-09): 0.01 to 99,999 CNY, median 19.9 - 95% of rows under 200 CNY and 99% under 1,000 CNY." }, "deeplApiKey": { "title": "Your DeepL API key", "type": "string", "description": "Optional. Put your own DeepL API key here and each product's Chinese title is also translated into English, in a new field, titleEn. The original title stays as it is, and nothing else is translated. DeepL counts the title characters against your DeepL account (titles are short, mostly under 40 characters); this actor charges nothing extra for it. If DeepL refuses the key, your characters run out or DeepL can't be reached, the products still come back with titleEn empty, plus one free row saying why. Leave this empty and the run is exactly as before. DeepL's own terms apply to your key and to what you do with the English titles." }, "maxRequests": { "title": "Maximum feed calls", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Optional hard ceiling on how many calls the run makes to Taobao. Each call returns 20 cards, about 13 of which are products the run has not seen yet (measured over 120 calls; the rate falls to about 8 by the hundredth call). Leave empty and the actor sizes the budget from \"maxItems\"." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional. Leave this alone unless you need the run to go out through a particular network. Your own proxy servers are used exactly as given." } } }, "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 } } } } } } } } } }