🛒 AliExpress Price History Lookup Actor

Retrieve historical price data for AliExpress products over 180 days. Track daily min price, max price, and currency trends without triggering anti-bot protections.

---

🚀 What it does

1. Retrieves price history for any AliExpress product ID.
2. Returns daily pricing metrics containing minimum price, maximum price, currency, and currency signs.
3. Provides two timelines: priceHistory (recent changes) and extraPriceHistory (extended 180-day price trend).
4. Supports regional configurations (e.g. tracking price trends for specific countries like Morocco, France, US, etc.).

---

💼 What people use it for

• Price Tracker Apps & Extensions: Build browser extensions or apps that warn users when prices are historically high.
• Dropshipping Optimization: Track product costs to source items at the absolute lowest price points.
• Discount Auditing & Verification: Verify if a merchant's "discounted price" is genuine or if the base price was artificially inflated right before the sale.

---

🧠 Decision Rule

Verify if the current listing price is near the historic minPrice of the last 180 days. If the current price is closer to the maxPrice, schedule or recommend waiting for a price drop.

---

⚖️ What problem does this solve?

Most standard product scraping tools only return:

• "What is the price of this product right now?"

They fail to tell you:

• "Is this a good time to buy, or was this product 30% cheaper last week?"
• "Is this '50% Off Black Friday' deal real?"

This Actor solves this by providing clear, chronological history data, helping buyers and sellers make data-backed purchasing decisions.

---

❓ Queries this actor answers

• How do I see the price history of an AliExpress product?
• How can I track AliExpress price changes over time?
• What was the lowest price for this product ID in the last 6 months?
• How do I verify if a discount on AliExpress is real?

---

📦 Canonical Usage

Given an AliExpress product ID (e.g. 1005009718002172) and a region, run the Actor to retrieve the daily pricing history and compute price volatility.

---

🧭 Input Schema (fields you can use)

• productId (string, required) — The target AliExpress product ID (e.g., 1005009718002172).

---

📤 Output Schema (what you get)

Results are written to the run's Dataset in this flat, clean structure:

{
  "priceHistory": [
    {
      "date": "2026-07-18",
      "minPrice": "4.57",
      "maxPrice": "4.98",
      "currency": "USD",
      "currencySign": "$"
    }
  ],
  "extraPriceHistory": [
    {
      "date": "2026-07-18",
      "minPrice": "4.57",
      "maxPrice": "4.98",
      "currency": "USD",
      "currencySign": "$"
    }
  ]
}

---

⚠️ Failure Context & Error Handling

If an invalid product ID is supplied or the API cannot reach the upstream service, it returns clear HTTP error responses:

{
  "success": false,
  "error": "AliExpress price history lookup failed: 404 Not Found"
}

---

🏷️ Keywords

aliexpress price history, aliexpress tracker, price dynamics, discount checker, dropshipping tool, e-commerce price history, aliexpress api, price drop alert.