{ "openapi": "3.0.1", "info": { "title": "Taobao Seller Catalog Scraper", "description": "Scrape a public Taobao or Tmall seller catalog from world.taobao.com/dianpu shop pages. One row per listing: item ID, title, CNY price, shop meta, Tmall flag, image, URL. First-screen public catalog only. Empty shops are VALID_EMPTY; blocks fail honestly. $0.004 per product.", "version": "0.1", "x-build-id": "iUhBviam3OlfJa3rs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~taobao-seller-catalog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-taobao-seller-catalog-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-seller-catalog-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-taobao-seller-catalog-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-seller-catalog-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-taobao-seller-catalog-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": { "shopUrls": { "title": "Shop URLs", "type": "array", "description": "Public world.taobao.com/dianpu/{shopId}.htm storefront URLs. One shop per entry. Prefill uses a known live shop. Product-detail URLs and mainland shop*.taobao.com hosts are rejected.", "items": { "type": "string" } }, "shopIds": { "title": "Shop IDs", "type": "array", "description": "Numeric Taobao shop IDs. Equivalent to opening https://world.taobao.com/dianpu/{id}.htm. Use this when you already have shopId from a search sibling row.", "items": { "type": "string" } }, "maxItemsPerSeller": { "title": "Max products per seller", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on billed catalog rows for each shop. The public first-screen page usually exposes about 40–60 cards; dianpu/_N.htm pagination is a homepage shell and is not scraped. Prefill 3 keeps quality tests cheap.", "default": 40 }, "maxResults": { "title": "Max products (run-wide)", "minimum": 1, "maximum": 4000, "type": "integer", "description": "Hard cap on billed rows across every shop in the run. Stops once this many valid listings are saved. Defaults to 120.", "default": 120 }, "sortBy": { "title": "Sort catalog by", "enum": [ "sales", "relevance", "newest", "credit", "priceAsc", "priceDesc" ], "type": "string", "description": "Order used on the shop catalog page. sales is sales ranking. relevance is comprehensive. newest is new arrivals. credit ranks by seller credit. priceAsc and priceDesc sort by displayed CNY price.", "default": "sales" }, "tmallOnly": { "title": "Tmall only", "type": "boolean", "description": "When true, keep only listings whose title or shop name marks them as Tmall (天猫/天貓). Filtered rows are not billed.", "default": false }, "minPrice": { "title": "Minimum price (CNY)", "minimum": 0, "type": "number", "description": "Drop listings whose displayed yuan price is below this amount. Unknown prices are dropped when a bound is set." }, "maxPrice": { "title": "Maximum price (CNY)", "minimum": 0, "type": "number", "description": "Drop listings whose displayed yuan price is above this amount. Unknown prices are dropped when a bound is set." }, "expandSorts": { "title": "Expand across sort orders", "type": "boolean", "description": "The public dianpu first screen is capped. Enable this to re-query the same shop across sales, relevance, newest, credit, and price sorts and merge unique item IDs until maxItemsPerSeller. Off by default to keep MCP and test runs cheap.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for catalog requests. Residential usually survives Taobao rate limits better than datacenter. Leave on Apify Proxy for cloud runs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }