{ "openapi": "3.0.1", "info": { "title": "AliExpress Search Scraper | Price Tracker & Best Sellers", "description": "Search AliExpress by keyword or paste search URLs and get product listings with price, original price, discount, rating and sales volume, in your ship-to country and currency. For AliExpress price tracking, dropshipping product research and competitor analysis.", "version": "0.0", "x-build-id": "2xdyLFSkhawT8AysP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/piotrv1001~aliexpress-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-piotrv1001-aliexpress-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/piotrv1001~aliexpress-listings-scraper/runs": { "post": { "operationId": "runs-sync-piotrv1001-aliexpress-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/piotrv1001~aliexpress-listings-scraper/run-sync": { "post": { "operationId": "run-sync-piotrv1001-aliexpress-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": { "searchQueries": { "title": "Search terms", "type": "array", "description": "What to search for on AliExpress, one term per line (a comma-separated list on one line is split too). The Actor builds the search URL for you — this is the easiest way to start.", "items": { "type": "string" } }, "searchUrls": { "title": "Search URLs", "type": "array", "description": "Optional. Paste AliExpress search result URLs to scrape them exactly as-is — useful when you have already applied filters on the site. Combined with any search terms above.", "items": { "type": "string" } }, "maxResults": { "title": "Max products", "minimum": 1, "type": "integer", "description": "Maximum number of products to return per run, across all search terms and URLs. Each AliExpress results page holds 60 products, so higher values fetch additional pages.", "default": 50 }, "shipTo": { "title": "Ship to", "type": "string", "description": "The country you buy for. Prices (including VAT where the country charges it on imports, such as the EU and UK), delivery estimates and the products shown all follow this country, as on AliExpress itself. Pick from the list or type a country code or name, for example DE or Germany. Default: United States.", "default": "US" }, "currency": { "title": "Currency", "type": "string", "description": "The currency for every price, for example EUR or GBP. Default: USD.", "default": "USD" }, "sort": { "title": "Sort by", "enum": [ "bestMatch", "orders", "priceAsc", "priceDesc" ], "type": "string", "description": "The order of results, the same choices as the sort bar on AliExpress. Most orders sorts each results page by units sold.", "default": "bestMatch" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Only products priced at or above this, in the currency chosen above. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Only products priced at or below this, in the currency chosen above. Leave empty for no maximum." }, "minOrders": { "title": "Minimum orders", "minimum": 0, "type": "integer", "description": "Only products with at least this many units sold (the totalSoldCount field). For a high minimum, sort by Most orders so the run finds them quickly." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only products rated at least this many stars out of 5, for example 4.5. Products with no rating yet are left out." }, "choiceOnly": { "title": "AliExpress Choice only", "type": "boolean", "description": "Only products in the AliExpress Choice program, which comes with faster delivery and easier returns.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "AliExpress blocks datacenter traffic aggressively. Leaving this on the default lets the Actor start on cheap proxies and fall back to residential only when it is actually blocked.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }