{ "openapi": "3.0.1", "info": { "title": "Alibaba Supplier/Company Listings Scraper", "description": "Input keywords(solar panel, car, etc) or direct listing URLs and country name or code to scrape unlimited Alibaba suppliers very fast. Outputs complete company profiles: supplier IDs, verification levels, Trade Assurance limits, revenue ranges, top markets, featured products, videos & more.", "version": "0.0", "x-build-id": "uCacIjgKH6ELnohpb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codenest~alibaba-supplier-company-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codenest-alibaba-supplier-company-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-supplier-company-listings-scraper/runs": { "post": { "operationId": "runs-sync-codenest-alibaba-supplier-company-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-supplier-company-listings-scraper/run-sync": { "post": { "operationId": "run-sync-codenest-alibaba-supplier-company-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. textiles, shoes, electric car)", "type": "array", "description": "Enter one or more search keywords (each line is one independent supplier search).\n\nThe scraper automatically constructs the exact Alibaba Countrysearch Manufacturer URL:\n 'textiles' + 'India' ➡️ 'https://www.alibaba.com/countrysearch/IN/manufacturer-textiles.html'\n 'shoes' + 'Vietnam' ➡️ 'https://www.alibaba.com/countrysearch/VN/manufacturer-shoes.html'\n\nAnd crawls the supplier listings across multiple pages to scrape full company details, verification levels, trade assurance, main products, revenue, markets, company images, and featured products.\n\nExample:\n• textiles\n• shoes\n• electric car", "items": { "type": "string" }, "default": [ "shoes" ] }, "country": { "title": "🌍 Country / Region (Name or 2-letter Code)", "type": "string", "description": "Enter the supplier country name or 2-letter ISO country code:\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" }, "urls": { "title": "🔗 Direct Alibaba Supplier URLs (Optional)", "type": "array", "description": "Optionally enter direct Alibaba.com supplier listing URLs to scrape (each line is one URL).\n\nSupported URL types:\n• Manufacturer listing pages (e.g. 'https://www.alibaba.com/countrysearch/IN/manufacturer-textiles.html')\n• Paginated supplier pages (e.g. 'https://www.alibaba.com/countrysearch/IN/manufacturer-textiles_2.html')\n• Supplier listing pages (e.g. 'https://www.alibaba.com/shoes-suppliers.html')", "items": { "type": "string" }, "default": [] }, "maxItems": { "title": "Maximum Suppliers Limit (Per Keyword/URL)", "minimum": 1, "type": "integer", "description": "Maximum number of suppliers to scrape per keyword search or listing URL. Default is 20.", "default": 20 }, "maxTotalChargeUsd": { "title": "Maximum Total Charge (USD)", "minimum": 0.01, "type": "number", "description": "Optional maximum spending limit in USD for Pay-Per-Event pricing (e.g. 5.00 for $5.00 USD). If reached, the scraper will gracefully stop and save all results scraped so far." }, "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 } } } } } } } } } }