{ "openapi": "3.0.1", "info": { "title": "Alibaba Scraper — Products, Suppliers, Prices & MOQ", "description": "Alibaba scraper for search results as flat rows: product, unit price range, MOQ, supplier name, years on Alibaba, country, review and service scores, badges, images. Filter by price, sort and supplier country. Monitor mode alerts on price and MOQ changes. $1 per 1,000, no login.", "version": "0.1", "x-build-id": "6O3bkdDyOqWCeoEXX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datahamster~alibaba-products/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datahamster-alibaba-products", "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/datahamster~alibaba-products/runs": { "post": { "operationId": "runs-sync-datahamster-alibaba-products", "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/datahamster~alibaba-products/run-sync": { "post": { "operationId": "run-sync-datahamster-alibaba-products", "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": { "queries": { "title": "Search queries", "type": "array", "description": "Alibaba search keywords, e.g. \"bluetooth speaker\". Each keyword is paginated separately; one result page holds up to 48 products.", "default": [ "bluetooth speaker" ], "items": { "type": "string" } }, "priceFrom": { "title": "Min price (USD)", "minimum": 0, "type": "integer", "description": "Lower unit-price bound in USD, passed to Alibaba's own price filter, e.g. 10. Leave empty for no lower bound." }, "priceTo": { "title": "Max price (USD)", "minimum": 0, "type": "integer", "description": "Upper unit-price bound in USD, passed to Alibaba's own price filter, e.g. 50. Leave empty for no upper bound." }, "sortBy": { "title": "Sort", "enum": [ "best_match", "price_asc", "price_desc", "orders" ], "type": "string", "description": "Result order: \"best_match\" (Alibaba default), \"price_asc\", \"price_desc\" or \"orders\" (most orders first). Example: \"best_match\".", "default": "best_match" }, "countryCode": { "title": "Supplier country", "type": "string", "description": "Supplier country filter as a two-letter ISO code, e.g. \"CN\", \"IN\", \"VN\" or \"TR\". Leave empty for suppliers from any country." }, "maxPages": { "title": "Pages per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many search-result pages to open per query, e.g. 1. Each page holds up to 48 products.", "default": 2 }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many pushed rows, e.g. 20. You are charged only for rows actually pushed.", "default": 20 }, "mode": { "title": "Mode", "enum": [ "scrape", "monitor" ], "type": "string", "description": "\"scrape\" returns every product found; \"monitor\" returns only products that are new or whose price, MOQ or review count changed since the previous run of the same saved Task. Example: \"scrape\".", "default": "scrape" }, "monitorStateId": { "title": "Monitor state id", "type": "string", "description": "Optional state id when not running as a saved task (monitor mode)" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "URL that receives a POST with the monitor-mode change summary (JSON), e.g. \"https://hooks.zapier.com/hooks/catch/123/abc\". Leave empty to skip." }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Optional Telegram bot token used to send monitor-mode change summaries, e.g. \"123456789:AAF...\". Leave empty to skip Telegram." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Optional Telegram chat id that receives monitor-mode summaries, e.g. \"-1001234567890\". Required only when telegramBotToken is set." } } }, "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 } } } } } } } } } }