{ "openapi": "3.0.1", "info": { "title": "Alibaba Supplier Scraper — B2B Sourcing AI Intelligence", "description": "Turn an Alibaba.com keyword search into a ranked, risk-scored supplier shortlist — a sourcing decision, not a raw data dump.", "version": "1.0", "x-build-id": "FSL7d8k5a3hxdPZ5R" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdatalabs~alibaba-b2b-sourcing-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdatalabs-alibaba-b2b-sourcing-intelligence", "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/webdatalabs~alibaba-b2b-sourcing-intelligence/runs": { "post": { "operationId": "runs-sync-webdatalabs-alibaba-b2b-sourcing-intelligence", "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/webdatalabs~alibaba-b2b-sourcing-intelligence/run-sync": { "post": { "operationId": "run-sync-webdatalabs-alibaba-b2b-sourcing-intelligence", "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": [ "searchKeywords" ], "properties": { "searchKeywords": { "title": "Search keywords", "minItems": 1, "type": "array", "description": "Products to source. Each keyword returns a ranked list of Alibaba.com suppliers. Example: \"stainless steel water bottle\".", "items": { "type": "string" } }, "targetMarket": { "title": "Target import market", "enum": [ "US", "EU", "UK", "CA", "AU", "Global" ], "type": "string", "description": "Where you will sell/import. Drives which certifications the AI checks each supplier against (e.g. CE/RoHS for EU, FCC/UL for US, FDA/LFGB for food-contact).", "default": "US" }, "maxSuppliers": { "title": "Maximum suppliers", "minimum": 1, "maximum": 500, "type": "integer", "description": "Total unique suppliers to return across all keywords. Keep low for a cheap trial run.", "default": 50 }, "aiAnalysis": { "title": "AI supplier analysis", "type": "boolean", "description": "Rank the top suppliers by risk, detect factory vs trading company, flag suspiciously cheap pricing, and list the certifications your target market requires. Requires an OpenAI API key configured on the Actor.", "default": true }, "sortBy": { "title": "Sort suppliers by", "enum": [ "relevance", "bestMatch", "mostOrders", "newest" ], "type": "string", "description": "Alibaba result ordering used before shortlisting.", "default": "relevance" }, "shortlistSize": { "title": "AI-analyzed suppliers per keyword", "minimum": 1, "maximum": 60, "type": "integer", "description": "How many top suppliers per keyword get the comparative AI analysis (risk rank, factory-vs-trader, price flags). The rest are returned with card-level data only.", "default": 25 }, "useApifyProxy": { "title": "Use Apify residential proxy", "type": "boolean", "description": "Required — Alibaba blocks datacenter and bare IPs. Leave on.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxy settings. The default is recommended.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }, "maxRetries": { "title": "Max retries", "minimum": 1, "maximum": 20, "type": "integer", "description": "Fresh-IP retries before giving up on a blocked request.", "default": 8 }, "debug": { "title": "Debug logging", "type": "boolean", "description": "Verbose per-request logging.", "default": false } } }, "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 } } } } } } } } } }