{ "openapi": "3.0.1", "info": { "title": "Alibaba Scraper โ€” Verified Supplier Ranking", "description": "๐Ÿ›’ Alibaba Scraper (alibaba-scraper) extracts product & supplier dataโ€”titles, specs, prices, MOQ, ratings, images. ๐Ÿ” Fast, scalable scraping with pagination & filters. ๐Ÿ“ฆ Export CSV/JSON. ๐Ÿ“Š Ideal for sourcing, market research, price tracking & lead gen.", "version": "0.1", "x-build-id": "8Yl8JgihQ7DnJNGtD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~alibaba-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-alibaba-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/scrapio~alibaba-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-alibaba-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/scrapio~alibaba-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-alibaba-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": [ "supplierListingUrls" ], "properties": { "supplierListingUrls": { "title": "๐Ÿ”— Supplier listing URLs", "type": "array", "description": "**Alibaba search-result or category-browse URLs to build the report from** โ€” one per line.\n\nโœ… Works with any listing view you can open logged-out in a browser (search results, category pages).\n\n๐Ÿงญ Tip: set your filters (keywords, category) on Alibaba first, then copy the address bar โ€” the filters travel with the URL.\n\n๐Ÿ“ฆ Paste many URLs to combine several searches into one report.\n\n(Backward-compatible: the base `urls` key is also accepted.)", "items": { "type": "string" } }, "maxSuppliers": { "title": "๐Ÿญ Max supplier rows", "minimum": 1, "maximum": 100000, "type": "integer", "description": "**Total number of product/supplier rows** to include in the report (across all URLs). Each row carries its own trust score and reorder rate.\n\n๐Ÿงฎ Alibaba returns ~48 products per result page; the actor opens just enough pages to reach this total, trimming any overflow so you get exactly this many rows.\n\n๐ŸŽฏ Try 10โ€“50 first, then raise. Default is 10.\n\n(Backward-compatible: the base `maxItems` key is also accepted.)", "default": 10 }, "sortByTrust": { "title": "โญ Rank rows by trust score", "type": "boolean", "description": "When ON, the collected rows are ranked by **supplierTrustScore** (highest first) before they are saved โ€” the most credible suppliers appear at the top of the dataset. Rows with no scoreable signal sort last.\n\nWhen OFF (default), rows are saved live in page order as each page finishes.\n\nExample: sortByTrust=true โ†’ your top-trust suppliers are rows 1, 2, 3โ€ฆ Default is false.", "default": false }, "maxPages": { "title": "๐Ÿ“„ Max pages per URL (override)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "**Optional** hard cap on how many result pages to open per URL. Leave at 0 to let the actor derive the page count from **Max supplier rows** automatically.\n\nSet a positive value only if you want to control paging directly (e.g. maxPages=3 opens pages 1โ€“3 per URL regardless of the row target). Default is 0 (auto).", "default": 0 }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy configuration", "type": "object", "description": "Enable Apify Proxy and pick a group. Residential is selected by default." } } }, "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 } } } } } } } } } }