{ "openapi": "3.0.1", "info": { "title": "AliExpress Search Scraper — past page 60, exact units sold", "description": "Every product of an AliExpress search, past its 60-page stop, each product once, with exact units sold.", "version": "1.0", "x-build-id": "a2NYZlfDrpqEhgqBE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pampadata~aliexpress-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pampadata-aliexpress-search-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/pampadata~aliexpress-search-scraper/runs": { "post": { "operationId": "runs-sync-pampadata-aliexpress-search-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/pampadata~aliexpress-search-scraper/run-sync": { "post": { "operationId": "run-sync-pampadata-aliexpress-search-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", "required": [ "searches" ], "properties": { "searches": { "title": "Searches", "type": "array", "description": "One per line: words as you would type them on AliExpress (\"fishing reel\", \"phone case\"), or an AliExpress search link (aliexpress.com/w/wholesale-....html). Price and sort in a link are kept.", "items": { "type": "string" } }, "shipTo": { "title": "Ship to (country)", "enum": [ "AE", "AR", "AT", "AU", "BE", "BR", "CA", "CH", "CL", "CO", "CZ", "DE", "ES", "FR", "GB", "IE", "IL", "IT", "JP", "KR", "KZ", "MX", "NL", "NZ", "PE", "PL", "PT", "SA", "SE", "TR", "UA", "US" ], "type": "string", "description": "Prices, delivery times and what AliExpress lists depend on the country it ships to.", "default": "US" }, "currency": { "title": "Currency", "enum": [ "AED", "AUD", "BRL", "CAD", "CHF", "CLP", "COP", "CZK", "EUR", "GBP", "ILS", "JPY", "KRW", "KZT", "MXN", "NZD", "PEN", "PLN", "SAR", "SEK", "TRY", "UAH", "USD" ], "type": "string", "description": "Prices come in this currency (AliExpress converts them). minPrice and maxPrice are in it too.", "default": "USD" }, "sort": { "title": "Sort", "enum": [ "relevance", "orders", "price_asc", "price_desc" ], "type": "string", "description": "Order of the list. With a limit per search, it decides which products you get first.", "default": "relevance" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "In the currency above. Empty = no minimum." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "In the currency above. Empty = no maximum." }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "AliExpress's own \"Free shipping\" filter.", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Deliver only products rated at least this (for example 4.5). Products below it, or without a rating yet, are skipped and not charged; the SUMMARY counts them. Empty = all." }, "maxProductsPerSearch": { "title": "Maximum products per search", "minimum": 0, "type": "integer", "description": "0 = every product AliExpress will show for the search. You pay per product, so set a limit for quick tests.", "default": 0 }, "goPastPageLimit": { "title": "Go past AliExpress's 60-page stop", "type": "boolean", "description": "AliExpress never shows more than 60 pages of a search. When a search reaches page 60, the run splits it into price bands and reads each one, so you get the products AliExpress would not show. Turn off to stop at page 60.", "default": true }, "includeRecommended": { "title": "Include AliExpress's 'recommended' cards", "type": "boolean", "description": "Some result pages mix in up to 30 'recommended for you' cards that are not search results (no units sold, rating or launch date, and outside your sort order). They are left out and not charged; the SUMMARY counts them. Tick to receive them too, marked isRecommendation: true.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave as is: residential IPs are included in the price (AliExpress shows its captcha to datacenter IPs within a few pages). If you pick your own proxies, they are used as given.", "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 } } } } } } } } } }