Overview

Search AliExpress products by keyword.

This endpoint calls AliExpress’s search API (POST) and returns a paginated set of product cards with titles, images, ratings, pricing, shipping info, and seller/store info.

Inputs

| Key | Type | Required | Default | Description | |-----|------|----------|---------|-------------| | keyword | string | No | laptop | Search term to query products | | page | number | No | 1 | Page number for pagination | | some | stringList | No | "" | Additional filter options (passed through as provided) |

Response

Returns a JSON object with a results array.

{
  "results": [
    {
      "image": {
        "imgUrl": "//ae-pic-a1.aliexpress-media.com/kf/S78e044dce8334b5a93f996095b5cd1c92.jpg",
        "imgWidth": 350,
        "imgHeight": 350,
        "imgType": "2"
      },
      "itemType": "productV3",
      "productId": "1005009977529376",
      "redirectedId": "1005009977529376",
      "title": {
        "displayTitle": "ACEMAGIC LX15PRO Laptop-Computer AMD Ryzen 7 7730U Windows Laptop 15,6-Zoll IPS 16GB DDR4 512GB NVMe SSD Numerische Tastatur"
      },
      "evaluation": {
        "starRating": 4.9,
        "starWidth": 73,
        "starHeight": 72
      },
      "lunchTime": "2025-09-17 00:00:00",
      "moreAction": {
        "actions": [
          {
            "actionType": "shopCart",
            "actionText": "In den Warenkorb",
            "actionIcon": "https://ae-pic-a1.aliexpress-media.com/kf/Sce512cd0bba1471087d31f4bfe7745a5O/64x64.png"
          }
        ]
      },
      "priceInfo": {
        "originalPrice": "862.68",
        "salePrice": "389.07",
        "currency": "EUR",
        "discount": "55%"
      },
      "shipping": {
        "freeShipping": true,
        "shippingFrom": "DE"
      },
      "seller": {
        "storeName": "Shop1103659154 Store",
        "companyName": "MICTW Supply Chain Service Singapore Private Limited"
      }
    }
  ]
}

Note: The response includes many additional fields (e.g., trace, extraParams, allPlatformInfo). Only the most commonly used/visible product-card fields are shown above.

Auth & Browser Notes

No authentication required, but AliExpress may require cookies/consistent headers.
If you receive empty results, retry with cookies set in update_cookies and/or reduce request frequency.

Example

Request

{
  "keyword": "laptop",
  "page": 1,
  "some": ""
}

Response (shape)

{
  "results": [
    {
      "productId": "1005009977529376",
      "title": {"displayTitle": "..."},
      "evaluation": {"starRating": 4.9},
      "image": {"imgUrl": "..."}
    }
  ]
}

Notes

Pricing and some optional fields can vary by region and availability.
Button/action text (e.g. cart button label) may depend on locale (example observed: In den Warenkorb).