{ "openapi": "3.0.1", "info": { "title": "Alibaba Product Listings Scraper", "description": "Input keywords, country filters, and max items to scrape unlimited Alibaba product listings. Outputs comprehensive bulk product data(100+ fields): titles, prices, specs, images, supplier details, customization options, payment methods & delivery rates.", "version": "0.0", "x-build-id": "fSfAVSotGGvmy9uIu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codenest~alibaba-product-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codenest-alibaba-product-listings-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/codenest~alibaba-product-listings-scraper/runs": { "post": { "operationId": "runs-sync-codenest-alibaba-product-listings-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/codenest~alibaba-product-listings-scraper/run-sync": { "post": { "operationId": "run-sync-codenest-alibaba-product-listings-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": { "keywords": { "title": "🔑 Keywords (e.g. EVE lifepo4 100ah, solar panel)", "type": "array", "description": "Enter one or more search keywords (each line is one independent product search).\n\nThe scraper automatically constructs the exact Alibaba Countrysearch URL:\n 'EVE lifepo4 100ah' ➡️ 'https://www.alibaba.com/countrysearch/CN/eve-lifepo4-100ah.html'\n\nAnd crawls the product listings to scrape full product details, tiered wholesale prices, MOQ, specifications, images, and supplier information.\n\nExample:\n• EVE lifepo4 100ah\n• solar panel\n• lithium battery 12v 100ah", "items": { "type": "string" }, "default": [ "EVE lifepo4 100ah" ] }, "urls": { "title": "🔗 Direct Alibaba URLs (Optional)", "type": "array", "description": "Optionally enter direct Alibaba.com URLs to scrape (each line is one URL).\n\nSupported URL types:\n• Countrysearch listing pages (e.g. 'https://www.alibaba.com/countrysearch/CN/eve-lifepo4-100ah.html')\n• Trade search listing pages (e.g. 'https://www.alibaba.com/trade/search?SearchText=...')\n• Direct product detail pages (e.g. 'https://www.alibaba.com/product-detail/...html')", "items": { "type": "string" }, "default": [] }, "country": { "title": "🌍 Country / Region (Name or 2-letter Code)", "type": "string", "description": "Enter the country name or 2-letter ISO country code for countrysearch URL generation:\n• India or IN\n• Vietnam or VN\n• Pakistan or PK\n• Turkey or TR\n• Bangladesh or BD\n• United States or US\n• China or CN (Default)\n• Germany or DE, Italy or IT, Japan or JP, etc.", "default": "CN" }, "maxItems": { "title": "Maximum Products Limit (Per Keyword/URL)", "minimum": 1, "type": "integer", "description": "Maximum number of products to scrape per keyword search or listing URL. Default is 20.", "default": 20 }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of product pages to scrape in parallel. Lower values are safer against rate-limiting. Default is 3.", "default": 3 }, "minDelayMs": { "title": "Minimum Delay (ms)", "minimum": 200, "type": "integer", "description": "Minimum random delay in milliseconds between requests. Default is 1000ms.", "default": 1000 }, "maxDelayMs": { "title": "Maximum Delay (ms)", "minimum": 500, "type": "integer", "description": "Maximum random delay in milliseconds between requests. Default is 3000ms.", "default": 3000 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Select Apify Proxy (Residential recommended) or provide custom proxy URLs for reliable scraping.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }