AliExpress Product Search API (V1)

Search for AliExpress products with optional query, page, sort, category, brand, location, attribute, price, locale, region, and currency controls. The request accepts a page number and a sort order when provided. Use it for catalog research or marketplace monitoring. The GET request schema also lists q. Use the results to organize a research workflow and cross-check the relevant source records.

Selected price
$0.015385 / callPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
Optional parameters (13)
Product search query.
One-based page number for pagination.
Sort order for product search results. Available Values: - `default`: Default result order - `salesDesc`: Sales volume, highest first - `priceAsc`: Price, lowest first - `priceDesc`: Price, highest first
Category ID used to filter product search results.
Brand ID used to filter product search results.
Location filter for product search results.
Search switches used to select optional result features.
Product attribute filter for search results.
Minimum product price filter, inclusive.
Maximum product price filter, inclusive.
Locale used for the AliExpress response.
AliExpress marketplace region.
Currency code used for product prices.

Sample response

{
  "code": 0,
  "data": {
    "result": {
      "base": {
        "pageSize": "20",
        "q": "iphone",
        "sortValues": [
          "default",
          "salesDesc",
          "priceAsc",
          "priceDesc"
        ],
        "switchesList": [],
        "totalResults": "64127"
      },
      "resultList": [
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.8,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/Af147575fa98843a0a359c6096ba29374j.png",
            "itemId": "3256810369281304",
            "itemUrl": "//www.aliexpress.com/item/3256810369281304.html",
            "sales": "146",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 205.07
              }
            },
            "title": "Apple iPhone 12 Smartphone 6.1\" Original Unlocked CellPhone Dual Sim Card Slot",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.5,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S2e43d7fc0aa244278f689dfafc6ae126R.jpg",
            "itemId": "3256810369096306",
            "itemUrl": "//www.aliexpress.com/item/3256810369096306.html",
            "sales": "224",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 176.49
              }
            },
            "title": "Original Apple iPhone 12 Mini Smartphone 5.4\" iOS Face ID NFC 5G Unlocked 12mini Mobile Phones",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.2,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S8bc87e8cc228441cb9115d510275c1eem.png",
            "itemId": "3256810466659245",
            "itemUrl": "//www.aliexpress.com/item/3256810466659245.html",
            "sales": "60",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 486.53
              }
            },
            "title": "Original iPhone 15 128GB/256GB/512GB ROM 6GB RAM Sim Free 5G Cell Phone iPhone15 Official Package",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.5,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S4e5c0ca0066b4c28beb542f816574203n.jpg",
            "itemId": "3256810382505438",
            "itemUrl": "//www.aliexpress.com/item/3256810382505438.html",
            "sales": "109",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 169.71
              }
            },
            "title": "Unlocked Original Apple iPhone 12 Mini Mobile Phones 64GB 128GB 256GB ROM IOS A14 Bionic Hexa Core 5.4'' Dual 12MP 5G 12Mini",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.8,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S166eb6a6db9343b695df5909cab00365s.png",
            "itemId": "3256810614551658",
            "itemUrl": "//www.aliexpress.com/item/3256810614551658.html",
            "sales": "63",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 649.09
              }
            },
            "title": "iPhone 16 Genuine 6.1\" eSIM/Physical SIM Genuine XDR OLED Face ID NFC A18 ROM 128/256/512GB RAM 8GB 5G AI Cell Phone 98% New",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.6,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/Sd8c381fa06d547c7aa3296e6b4a55dbfQ.jpg",
            "itemId": "3256810415557075",
            "itemUrl": "//www.aliexpress.com/item/3256810415557075.html",
            "sales": "339",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 33.83
              }
            },
            "title": "Original Apple iPhone 6 Unlocked 4.7 inch IOS12 Fingerprint Mobile Cell Phone Can't Use icloud ID and New APP",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 5,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S6b8f2eb7645d4fefa3d85e2032f4a31c2.png",
            "itemId": "3256805666211665",
            "itemUrl": "//www.aliexpress.com/item/3256805666211665.html",
            "sales": "25",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 382.49
              }
            },
            "title": "Apple iPhone 12 Pro Max / 13 Pro Max 128/256/512GB ROM Original 6.7\" Retina OLED RAM 6GB Face ID NFC Unlocked 5G Mobile Phones",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 5,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S9b1d0d5ed2be4e13a891ad2830e99400i.jpg",
            "itemId": "3256811786512678",
            "itemUrl": "//www.aliexpress.com/item/3256811786512678.html",
            "sales": "34",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 55.8
              }
            },
            "title": "Apple Original iPhone 6 Plus Mobile Cell Phone 5.5\" 8MP ROM 16/64/128GB Dual Core IOS Fingerprint 4G LTE Unlocked 6P Cellphone",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 2.8,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/Sf2f79d0168f24f71b450e6a715f539f1T.png",
            "itemId": "3256810610732695",
            "itemUrl": "//www.aliexpress.com/item/3256810610732695.html",
            "sales": "34",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 1026.55
              }
            },
            "title": "Original iPhone 16 Pro Max 6.9\" Genuine Physical SIM/eSIM Genuine XDR OLED Face ID NFC A18Pro 8GB 256/512GB/1TB 5G Mobile Phone",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.9,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S13dde7884ae4470f9af3f6745b7dd96bz.jpg",
            "itemId": "3256811861940740",
            "itemUrl": "//www.aliexpress.com/item/3256811861940740.html",
            "sales": "77",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 35.65
              }
            },
            "title": "Original Apple iPhone 5s 4G Mobile Cell Phone 4.0\" ROM 16GB WIFI IOS Fingerprint Unlocked CellPhone.",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.9,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S5d7e7d965d0d43ce969c90b32b75f3217.png",
            "itemId": "3256805557197661",
            "itemUrl": "//www.aliexpress.com/item/3256805557197661.html",
            "sales": "24",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 259.19
              }
            },
            "title": "Apple iPhone 11 Pro Max ProMax 64GB 256GB 6.5\" Genuine Super Retina XDR OLED Face ID A13 Bion 4G 98% New Phone 20W Fast Charger",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 5,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/Saa915bcad7b54ae39d341899bad07725G.jpg",
            "itemId": "3256812510307904",
            "itemUrl": "//www.aliexpress.com/item/3256812510307904.html",
            "sales": "4",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 484.24
              }
            },
            "title": "iPhone 13 pro A2483 6GB RAM 128/256/512GB ROM 5G 6.1' 12MP A15 Bionic Super Retina XDR OLED Face ID NFC eSIM iOS Mobile Phone",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": null,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/A4891c078d48143adb6b5a374757f9609I.png",
            "itemId": "3256812521753571",
            "itemUrl": "//www.aliexpress.com/item/3256812521753571.html",
            "sales": 0,
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 1391.79
              }
            },
            "title": "Original Apple iPhone 17 Pro Max, US Version, ESIM, 256GB/512GB/1TB/2TB - Unlocked (Like New)",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.1,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/Sc59de35402554ed8aa27e8f5315584cdK.png",
            "itemId": "3256810467095399",
            "itemUrl": "//www.aliexpress.com/item/3256810467095399.html",
            "sales": "97",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 633.99
              }
            },
            "title": "Original iPhone 15 Pro 15Pro 128GB/256GB/512GB/1TB ROM 8GB RAM Sim Free 5G Cell Phone Official Package",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 5,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S8304f74d2d1340cd9ba1d7bbc9dc8c581.jpg",
            "itemId": "3256808971681394",
            "itemUrl": "//www.aliexpress.com/item/3256808971681394.html",
            "sales": "52",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 80.57
              }
            },
            "title": "Original Unlocked Apple iPhone SE Mobile Cellphone 16/32/64/128GB ROM 2GB RAM  iPhone SE Dual Core 4G LTE Touch ID Smartphone",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.9,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S9ccf3b2820fb460cb6ce932b6981ba7b0.jpg",
            "itemId": "3256810569901588",
            "itemUrl": "//www.aliexpress.com/item/3256810569901588.html",
            "sales": "152",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 144.95
              }
            },
            "title": "Apple iPhone XR 3G 4G LTE Mobile Cell Phone Original Unlocked Face ID 6.1\" Retina12MP IOS CellPhone",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.3,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S8089184e66724ef9bec0d569340390a2z.png",
            "itemId": "3256810524306186",
            "itemUrl": "//www.aliexpress.com/item/3256810524306186.html",
            "sales": "162",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 700.27
              }
            },
            "title": "Original iPhone 16 128GB/256GB/512GB ROM 8GB RAM Unlocked 5G Cell Phone iPhone16 Battery Health Above 90% Looks Like New",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.8,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S97c78aaac7cd47ce9dfb355a936988a1J.jpg",
            "itemId": "3256810369074883",
            "itemUrl": "//www.aliexpress.com/item/3256810369074883.html",
            "sales": "236",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 410.2
              }
            },
            "title": "Apple iPhone 13 Pro 6.1\" Phone 13 Pro Max 6.7\" Original Retina OLED Face ID Unlocked 5G Mobile Phone",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.6,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S6787c59d6775428a91121f662d468988p.jpg",
            "itemId": "3256807743356812",
            "itemUrl": "//www.aliexpress.com/item/3256807743356812.html",
            "sales": "71",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 34.84
              }
            },
            "title": "Original Apple iPhone 6 iPhone6 4.7\" IOS A8 8MP ROM16/64/128GB Dual Core Fingerprint 4G LTE Unlocked Mobile Cell Phone",
            "type": "natural"
          },
          "sellingPoints": null
        },
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.9,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/Se9f1dc2eacaa4b328a244c766ab1d789q.jpg",
            "itemId": "3256810563178304",
            "itemUrl": "//www.aliexpress.com/item/3256810563178304.html",
            "sales": "154",
            "sku": {
              "def": {
                "price": null,
                "promotionPrice": 53.91
              }
            },
            "title": "Original Apple iPhone 6 iPhone6 4.7\" IOS A8 8MP 1GB RAM 16/64/128GB ROM Dual Core Fingerprint 4G LTE Cell Phone",
            "type": "natural"
          },
          "sellingPoints": null
        }
      ]
    }
  },
  "message": null,
  "recordTime": null
}

Response result

Response structure

Inferred from examples
  • codeinteger
  • dataobject
    • resultobject
      • baseobject
        • pageSizestring
        • qstring
        • sortValuesstring[]
        • switchesListunknown[]
        • totalResultsstring
      • resultListobject[]
        • deliverynull
        • itemobject
          • averageStarRatenumber | null
          • imagestring
          • itemIdstring
          • itemUrlstring
          • salesstring | integer
          • skuobject
            • defobject
              • pricenull
              • promotionPricenumber
          • titlestring
          • typestring
        • sellingPointsnull
  • messagenull
  • recordTimenull

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use AliExpress Product Search API (V1) with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.