{ "openapi": "3.0.1", "info": { "title": "Alibaba Supplier/Company Scraper", "description": "Input keyword, country name or supplier profile URLs to scrape detailed company data. Outputs complete business intelligence: verification status, manufacturing capabilities, R&D capacity, trade markets, production metrics & more.", "version": "0.0", "x-build-id": "G5cEMlBJ9w2N7QRLf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/codenest~alibaba-supplier-company-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-codenest-alibaba-supplier-company-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-scraper/runs": { "post": { "operationId": "runs-sync-codenest-alibaba-supplier-company-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-scraper/run-sync": { "post": { "operationId": "run-sync-codenest-alibaba-supplier-company-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 storefront or listing URLs to scrape (each line is one URL).\n\nSupported URL types:\n• Direct Supplier Storefront / Profile URLs (e.g. 'https://ytqc.en.alibaba.com/', 'https://ytqc.en.alibaba.com/company_profile.html')\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 }, "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 } } } } } } } } } }