{ "openapi": "3.0.1", "info": { "title": "Alibaba Product Scraper", "description": "Turn Alibaba product links into a clean table of wholesale terms: every quantity-break price in US dollars, minimum order quantity, lead times, variants, certificates and the manufacturer behind the listing. Compare suppliers side by side and build a sourcing shortlist in one sheet.", "version": "0.0", "x-build-id": "AfpBcECbAtCpZ7gAH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apt_marble~alibaba-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apt_marble-alibaba-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/apt_marble~alibaba-product-scraper/runs": { "post": { "operationId": "runs-sync-apt_marble-alibaba-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/apt_marble~alibaba-product-scraper/run-sync": { "post": { "operationId": "run-sync-apt_marble-alibaba-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": [ "productUrls" ], "properties": { "productUrls": { "title": "Alibaba products", "type": "array", "description": "Product page addresses copied from Alibaba, or bare product numbers. One per line. Anything else in the list is skipped and reported.", "default": [ "https://www.alibaba.com/product-detail/x_1601739545402.html" ], "items": { "type": "string" } }, "country": { "title": "Country to buy from", "enum": [ "us", "gb", "de", "fr", "es", "it", "nl", "pl", "ca", "au", "br", "mx", "ru", "sa", "ae", "il", "kr", "jp", "in", "sg", "cl", "za" ], "type": "string", "description": "Which country's version of the site to read. Wholesale prices are always returned in US dollars as well, so results stay comparable whichever country you pick.", "default": "us" }, "includeDescription": { "title": "Include the supplier's full description", "type": "boolean", "description": "Attach the supplier's own product write-up, with its images, to every result. Charged as a full product detail on top of the base result.", "default": false }, "includeSimilarProducts": { "title": "Include related products", "type": "boolean", "description": "Attach a short list of comparable products the site shows next to each item, useful for benchmarking a quote.", "default": false }, "maxSimilarProducts": { "title": "Related products per item", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many related products to attach to each result when the option above is on.", "default": 12 }, "maxProducts": { "title": "Maximum products", "minimum": 1, "maximum": 300, "type": "integer", "description": "Safety cap on how many products one run reads. Anything beyond the cap is reported as not attempted rather than silently dropped.", "default": 50 }, "gapBetweenProductsSeconds": { "title": "Gap between products (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Minimum pause between reading one product and the next. Alibaba serves detailed wholesale pages slowly and stops answering when they are asked for too quickly, so the pause cannot be set below five seconds. Raise it for very large jobs.", "default": 5 }, "productsAtOnce": { "title": "Products at once", "minimum": 1, "maximum": 2, "type": "integer", "description": "How many products may be in progress at the same time. One is the recommended and default setting; two is the maximum this source supports before it starts refusing.", "default": 1 } } }, "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 } } } } } } } } } }