{ "openapi": "3.0.1", "info": { "title": "Alibaba Supplier Scraper & API - Store Catalogs, MOQ, Prices", "description": "Alibaba supplier scraper: every product an Alibaba supplier store lists, by store URL, product URL or keyword. One result = one product: price, MOQ, certificates, sold count, store category, plus supplier verification, rating, years, staff, rankings and capabilities. $1.00 per 1,000, no start fee.", "version": "1.0", "x-build-id": "7Vz5kuYfTk27Ae9vv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rel8ble~alibaba-supplier-store-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rel8ble-alibaba-supplier-store-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/rel8ble~alibaba-supplier-store-scraper/runs": { "post": { "operationId": "runs-sync-rel8ble-alibaba-supplier-store-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/rel8ble~alibaba-supplier-store-scraper/run-sync": { "post": { "operationId": "run-sync-rel8ble-alibaba-supplier-store-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": { "storeUrls": { "title": "Supplier stores (URLs or names)", "type": "array", "description": "Supplier storefronts to scrape, one per line: https://alextechnology.en.alibaba.com/ (any page of the store works), just the store name alextechnology, or a store category URL (.../productgrouplist-818986374/Open_Ear_Headphone.html) to scrape one category only. An Alibaba product URL also works: its supplier store is scraped. Tip: feed it the supplierUrl column from our Alibaba search scraper.", "items": { "type": "string" } }, "searchTerms": { "title": "Find stores by keyword", "type": "array", "description": "Optional. Keywords (e.g. \"yoga mat\") or alibaba.com search URLs. The scraper searches Alibaba, takes the suppliers behind the results (up to Max stores per search) and scrapes their stores. Leave empty when you give stores directly. With no input at all, a 20-product demo store runs.", "items": { "type": "string" } }, "maxStoresPerSearch": { "title": "Max stores per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Optional, search terms only. Supplier stores taken per search term, integer 1-100. Default 5.", "default": 5 }, "maxProductsPerStore": { "title": "Max products per store", "minimum": 0, "type": "integer", "description": "Optional. Products saved per store (or per store category), integer >= 0. Default 100; 0 = the whole catalog (up to 4,000 per store). You pay per product, so start small.", "default": 100 }, "keywordInStore": { "title": "Keyword inside each store", "type": "string", "description": "Optional. Search inside every store for this word (e.g. \"earphone\") and only return matching products. Leave empty for the whole catalog." }, "readyToShipOnly": { "title": "Ready-to-ship products only", "type": "boolean", "description": "Optional boolean. true = only products Alibaba marks ready to ship (in stock, fixed price, fast dispatch). Default false.", "default": false }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "type": "number", "description": "Optional filter. Skip products whose highest price is below this. Skipped products are not charged." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "type": "number", "description": "Optional filter. Skip products whose lowest price is above this. Skipped products are not charged." }, "maxMoq": { "title": "Max MOQ", "minimum": 1, "type": "integer", "description": "Optional filter. Skip products whose minimum order quantity is above this. Skipped products are not charged." }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Optional, advanced. Parallel requests, integer 1-20. Default 5. Leave unset.", "default": 5 }, "maxRequestRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 20, "type": "integer", "description": "Optional, advanced. Retries per failed or blocked request, integer 0-20; each retry uses a new session. Default 6.", "default": 6 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional, advanced. Leave as is. Default {\"useApifyProxy\": false} = automatic: direct connection first, and only requests that get blocked are retried through Apify Proxy (datacenter, then residential). Set your own Apify Proxy groups or proxy URLs to force them for every request.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }