{
  "openapi": "3.0.1",
  "info": {
    "title": "AliExpress Product Details Scraper - Variants & Shipping",
    "description": "Every AliExpress product page as clean JSON, by link or number: each variant's price, 30-day low and stock, delivery fee and window for your country, rating, sold count, specs and images. Run it again and every variant says what moved. No seller data, ever.",
    "version": "0.1",
    "x-build-id": "HV0A38WgazUWvSuyn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lowlanddata~aliexpress-product-details-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lowlanddata-aliexpress-product-details-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/lowlanddata~aliexpress-product-details-scraper/runs": {
      "post": {
        "operationId": "runs-sync-lowlanddata-aliexpress-product-details-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/lowlanddata~aliexpress-product-details-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-lowlanddata-aliexpress-product-details-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": {
          "productUrls": {
            "title": "Product links",
            "type": "array",
            "description": "AliExpress product pages, one per line: https://www.aliexpress.com/item/1005006959700436.html. Any country domain works (nl.aliexpress.com, aliexpress.us), tracking parameters are ignored, and app share links (a.aliexpress.com/_xyz) or affiliate links (s.click.aliexpress.com/e/_xyz) are followed to the product. A search or store page is refused with a pointer before anything is charged.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "productIds": {
            "title": "Product numbers",
            "type": "array",
            "description": "Bare product numbers (1005006959700436), one per line or several per line separated by commas or spaces, for example a column pasted from a spreadsheet or the <code>productId</code> field of the AliExpress Scraper's rows. Links work here too. Each product is read and billed once, however many times it appears.",
            "items": {
              "type": "string"
            }
          },
          "shipTo": {
            "title": "Ship to (country)",
            "enum": [
              "US",
              "GB",
              "DE",
              "FR",
              "ES",
              "IT",
              "NL",
              "BE",
              "PL",
              "SE",
              "CA",
              "AU",
              "BR",
              "IN",
              "MX"
            ],
            "type": "string",
            "description": "The country prices, stock and delivery are calculated for. AliExpress quotes different offers, shipping options and a different currency per destination, so this decides what you get, not just the exchange rate.",
            "default": "US"
          },
          "currency": {
            "title": "Currency (optional)",
            "type": "string",
            "description": "A three-letter code (USD, EUR, GBP) to quote every price in. Leave empty for the destination's own currency, listed next to each country above."
          },
          "includeDescription": {
            "title": "Add the description text",
            "type": "boolean",
            "description": "Also read the seller's description page and add <code>descriptionText</code> (plain text, up to 20,000 characters) and <code>descriptionImages</code> to each row. One extra request per product, no extra charge. Off by default because most price and stock jobs do not need it.",
            "default": false
          },
          "trackChanges": {
            "title": "Remember prices and stock between runs",
            "type": "boolean",
            "description": "When on, each run keeps the price, stock, sold figure, review count and rating per product, and the price and stock per variant, for this task. The next run adds <code>priceDelta</code>, <code>stockDelta</code>, <code>soldDelta</code>, <code>reviewCountDelta</code> and <code>ratingDelta</code> to every row, with the previous values and <code>previousRunAt</code>, and a price and stock move to every variant. The first run only records a baseline.",
            "default": true
          },
          "resetMemory": {
            "title": "Forget previous runs",
            "type": "boolean",
            "description": "Start the change memory over for this task: this run becomes the new baseline.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum products",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Stop after this many products. Products that are gone from AliExpress are not charged and do not count.",
            "default": 50
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "AliExpress refuses many datacenter addresses on its product endpoint, so the run uses a residential session through German exits. Prices and shipping follow Ship to either way, because the destination travels in the request. Leave this as it is unless you have your own proxies; a blocked exit is rotated away from automatically.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          },
          "reportFailures": {
            "title": "Anonymous reports to the developer",
            "type": "boolean",
            "description": "Only two things are sent to the developer. When a run fails: the actor name and build, an error category, the truncated error message and a one-way hash of your input. At the start of every run: the actor name, the build, a one-way hash of your Apify account id and whether the account is on a paid Apify plan. <b>Your input, your results, your name and your account id itself are never sent.</b> Turn this off and nothing is sent; the actor behaves the same.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}