AliExpress API

API ID 15172

Online marketplace product data: search with filters, product details, SKU variations, shipping to any country, descriptions and reviews in 48 currencies and 16 languages.

API Documentation

Endpoints

Request
Lists the currencies accepted by the "currency" parameter, each with its code and name.
Endpoint ID: 40476
GET https://zylalabs.com/api/15172/aliexpress+api/40476/get+currencies
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "code": "USD",
        "name": "US Dollar"
    },
    {
        "code": "EUR",
        "name": "Euro"
    },
    {
        "code": "GBP",
        "name": "British Pound"
    },
    {
        "code": "CAD",
        "name": "Canadian Dollar"
    },
    {
        "code": "AUD",
        "name": "Australian Dollar"
    },
    {
        "code": "NZD",
        "name": "New Zealand Dollar"
    },
    {
        "code": "CHF",
        "name": "Swiss Franc"
    },
    {
        "code": "SEK",
        "name": "Swedish Krona"
    },
    {
        "code": "NOK",
        "name": "Norwegian Krone"
    },
    {
        "code": "DKK",
        "name": "Danish Krone"
    },
    {
        "code": "PLN",
        "name": "Polish Zloty"
    },
    {
        "code": "CZK",
        "name": "Czech Koruna"
    },
    {
        "code": "HUF",
        "name": "Hungarian Forint"
    },
    {
        "code": "RON",
        "name": "Romanian Leu"
    },
    {
        "code": "BGN",
        "name": "Bulgarian Lev"
    },
    {
        "code": "RSD",
        "name": "Serbian Dinar"
    },
    {
        "code": "UAH",
        "name": "Ukrainian Hryvnia"
    },
    {
        "code": "BYN",
        "name": "Belarusian Ruble"
    },
    {
        "code": "RUB",
        "name": "Russian Ruble"
    },
    {
        "code": "KZT",
        "name": "Kazakhstani Tenge"
    },
    {
        "code": "TRY",
        "name": "Turkish Lira"
    },
    {
        "code": "ILS",
        "name": "Israeli New Shekel"
    },
    {
        "code": "SAR",
        "name": "Saudi Riyal"
    },
    {
        "code": "AED",
        "name": "UAE Dirham"
    },
    {
        "code": "QAR",
        "name": "Qatari Riyal"
    },
    {
        "code": "KWD",
        "name": "Kuwaiti Dinar"
    },
    {
        "code": "BHD",
        "name": "Bahraini Dinar"
    },
    {
        "code": "EGP",
        "name": "Egyptian Pound"
    },
    {
        "code": "MAD",
        "name": "Moroccan Dirham"
    },
    {
        "code": "NGN",
        "name": "Nigerian Naira"
    },
    {
        "code": "ZAR",
        "name": "South African Rand"
    },
    {
        "code": "JPY",
        "name": "Japanese Yen"
    },
    {
        "code": "KRW",
        "name": "South Korean Won"
    },
    {
        "code": "INR",
        "name": "Indian Rupee"
    },
    {
        "code": "IDR",
        "name": "Indonesian Rupiah"
    },
    {
        "code": "THB",
        "name": "Thai Baht"
    },
    {
        "code": "VND",
        "name": "Vietnamese Dong"
    },
    {
        "code": "MYR",
        "name": "Malaysian Ringgit"
    },
    {
        "code": "PHP",
        "name": "Philippine Peso"
    },
    {
        "code": "SGD",
        "name": "Singapore Dollar"
    },
    {
        "code": "HKD",
        "name": "Hong Kong Dollar"
    },
    {
        "code": "TWD",
        "name": "New Taiwan Dollar"
    },
    {
        "code": "BRL",
        "name": "Brazilian Real"
    },
    {
        "code": "MXN",
        "name": "Mexican Peso"
    },
    {
        "code": "CLP",
        "name": "Chilean Peso"
    },
    {
        "code": "COP",
        "name": "Colombian Peso"
    },
    {
        "code": "PEN",
        "name": "Peruvian Sol"
    },
    {
        "code": "ARS",
        "name": "Argentine Peso"
    }
]
Get currencies — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40476/get+currencies' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the languages accepted by the "language" parameter, each with its code and name.
Endpoint ID: 40477
GET https://zylalabs.com/api/15172/aliexpress+api/40477/get+languages
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "code": "en",
        "name": "English"
    },
    {
        "code": "ar",
        "name": "Arabic"
    },
    {
        "code": "de",
        "name": "German"
    },
    {
        "code": "es",
        "name": "Spanish"
    },
    {
        "code": "fr",
        "name": "French"
    },
    {
        "code": "he",
        "name": "Hebrew"
    },
    {
        "code": "it",
        "name": "Italian"
    },
    {
        "code": "ja",
        "name": "Japanese"
    },
    {
        "code": "ko",
        "name": "Korean"
    },
    {
        "code": "nl",
        "name": "Dutch"
    },
    {
        "code": "pl",
        "name": "Polish"
    },
    {
        "code": "pt",
        "name": "Portuguese"
    },
    {
        "code": "ru",
        "name": "Russian"
    },
    {
        "code": "th",
        "name": "Thai"
    },
    {
        "code": "tr",
        "name": "Turkish"
    },
    {
        "code": "uk",
        "name": "Ukrainian"
    }
]
Get languages — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40477/get+languages' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the values accepted by the "sort" parameter of the /search endpoint.
Endpoint ID: 40478
GET https://zylalabs.com/api/15172/aliexpress+api/40478/get+sort+orders
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "value": "best_match",
        "label": "Best match"
    },
    {
        "value": "orders",
        "label": "Most orders"
    },
    {
        "value": "price_asc",
        "label": "Price: low to high"
    },
    {
        "value": "price_desc",
        "label": "Price: high to low"
    }
]
Get sort orders — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40478/get+sort+orders' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the values accepted by the "filter" parameter of the /product/reviews endpoint.
Endpoint ID: 40479
GET https://zylalabs.com/api/15172/aliexpress+api/40479/get+review+filters
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
[
    {
        "value": "all",
        "label": "All reviews"
    },
    {
        "value": "images",
        "label": "With images"
    },
    {
        "value": "additional",
        "label": "With an additional review"
    },
    {
        "value": "local",
        "label": "From the delivery country"
    },
    {
        "value": "5",
        "label": "5 stars"
    },
    {
        "value": "4",
        "label": "4 stars"
    },
    {
        "value": "3",
        "label": "3 stars"
    },
    {
        "value": "2",
        "label": "2 stars"
    },
    {
        "value": "1",
        "label": "1 star"
    }
]
Get review filters — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40479/get+review+filters' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the details of a product: title, category, price range, original price, discount and currency, stock, minimum order quantity, rating, number of ratings, number sold, wishlist count, store with its id, name, seller id and top rated flag, images, video, specifications and package size and weight.
Endpoint ID: 40480
GET https://zylalabs.com/api/15172/aliexpress+api/40480/get+product+details
INPUT PARAMETERS

Get product details — Endpoint Features

Object Description
product_id Required Product id (e.g. "1005009940780547"). Use the /search endpoint to list valid values.
country Optional Optional two-letter ISO code of the delivery country (e.g. "DE", defaults to "US"). Prices, shipping and stock are those for delivery to this country.
currency Optional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Optional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

product_id
country
currency
language
API EXAMPLE RESPONSE
JSON
{
    "product_id": "1005009940780547",
    "title": "QCY H3S -56dB Adaptive ANC Over Ear Headphone Hi-Res LDAC Spatial Sound Wireless Earphone Bluetooth 6.0 Dual Driver 102H Headset",
    "url": "https://www.aliexpress.com/item/1005009940780547.html",
    "category_id": "63705",
    "top_category_id": "44",
    "price": 38.79,
    "price_max": 38.79,
    "original_price": 100.6,
    "currency": "USD",
    "price_display": "$38.79",
    "discount_percent": 61,
    "in_stock": true,
    "min_order_quantity": 1,
    "rating": 4.8,
    "ratings_count": 1777,
    "sold": 5000,
    "sold_display": "5,000+ sold",
    "wishlist_count": 7556,
    "store": {
        "id": "1455660",
        "name": "QCY Official Store",
        "url": "https://www.aliexpress.com/store/1455660",
        "seller_id": "221859663",
        "is_top_rated": false,
        "is_local_seller": false
    },
    "images": [
        "https://ae-pic-a1.aliexpress-media.com/kf/Sf8cf6d6b13a5456e80d462b759b55372U.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/Sfca545d9ce334a289b7766a3d3d26bb3h.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S8fff04b36a1d47a3847615817c725093a.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S67be5ded304f4009861a9028df388b25P.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/Sdf75c9a0a15041c8b85b0cc4d6787cfa0.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/Scab2d0f296924dc0948ebdaedfc51471r.jpg"
    ],
    "video": "https://video.aliexpress-media.com/play/u/ae_sg_item/2227548615/p/1/e/6/t/10301/5000592242766.mp4",
    "video_poster": "https://ae-pic-a1.aliexpress-media.com/kf/Sae44044ca47b4dc993b7ebfa4be6009am.jpg",
    "specifications": [
        {
            "name": "Department",
            "value": "Unisex-adult"
        },
        {
            "name": "High-concerned chemical",
            "value": "None"
        },
        {
            "name": "Material",
            "value": "ABS"
        },
        {
            "name": "Weight[g]",
            "value": "240g"
        },
        {
            "name": "Battery Capacity[mAh]",
            "value": "750"
        },
        {
            "name": "Battery life up to[hours]",
            "value": "102 hours ANC off"
        },
        {
            "name": "Voice assistant built-in",
            "value": "Yes"
        },
        {
            "name": "Maximum wireless range[m]",
            "value": "10m-20m"
        },
        {
            "name": "NFC Technology",
            "value": "no"
        },
        {
            "name": "Sound Isolating",
            "value": "Yes"
        },
        {
            "name": "Category",
            "value": "Earphones & Headphones"
        },
        {
            "name": "Earcups Type",
            "value": "Sealed"
        },
        {
            "name": "Charging Method",
            "value": "cable"
        },
        {
            "name": "Headphone Pads Material",
            "value": "Fabric"
        },
        {
            "name": "Driver Diameter",
            "value": "40mm"
        },
        {
            "name": "Bluetooth Version",
            "value": "Other"
        },
        {
            "name": "Package List",
            "value": "User Manual,Charging Cable"
        },
        {
            "name": "Features",
            "value": "Active Noice Cancelling,Dual Connection"
        },
        {
            "name": "Codecs",
            "value": "sbc,LDAC"
        },
        {
            "name": "Is wireless",
            "value": "Yes"
        },
        {
            "name": "Support APP",
            "value": "Yes"
        },
        {
            "name": "Audio latency",
            "value": "60ms"
        },
        {
            "name": "Control Method",
            "value": "Push button,App"
        },
        {
            "name": "Waterproof",
            "value": "No"
        },
        {
            "name": "whether electrical",
            "value": "No"
        },
        {
            "name": "Frequency Response Range",
            "value": "20 - 40000Hz"
        },
        {
            "name": "Speaker maximum output power",
            "value": "40mW"
        },
        {
            "name": "Charging Time",
            "value": "2H"
        },
        {
            "name": "Function",
            "value": "For Internet Bar,for Video Game,Common Headphone,For Mobile Phone,HiFi Headphone,Sport,For Outdoor,For Office,For Study"
        },
        {
            "name": "Active Noise-Cancellation",
            "value": "Yes"
        },
        {
            "name": "Volume Control",
            "value": "Yes"
        },
        {
            "name": "Control Button",
            "value": "Yes"
        },
        {
            "name": "Vocalism Principle",
            "value": "Other"
        },
        {
            "name": "Wireless Type",
            "value": "Bluetooth"
        },
        {
            "name": "Connectors",
            "value": "Type c"
        },
        {
            "name": "Communication",
            "value": "Wireless+Wired"
        },
        {
            "name": "Style",
            "value": "Wireless headphone & headset"
        },
        {
            "name": "Certification",
            "value": "CE,FCC,RoHS,BQB"
        },
        {
            "name": "Origin",
            "value": "Mainland China"
        },
        {
            "name": "Brand Name",
            "value": "QCY"
        },
        {
            "name": "QCY Model",
            "value": "Other"
        },
        {
            "name": "Support Memory Card",
            "value": "No"
        },
        {
            "name": "QCY H3S",
            "value": "QCY H3S ANC"
        },
        {
            "name": "qcy anc headphones",
            "value": "fone qcy h3s"
        },
        {
            "name": "fone de ouvido bluetooth",
            "value": "fone de ouvido"
        },
        {
            "name": "QCY H3S Over Ear Headphones",
            "value": "Hi-Res Audio with LDAC"
        },
        {
            "name": "360° Spatial Sound",
            "value": "-56dB Adaptive ANC"
        },
        {
            "name": "Wireless / Wired Mode Support",
            "value": "Adaptive Noise Cancellatlon"
        },
        {
            "name": "60ms Low Latency",
            "value": "Upgrade Transparency Mode"
        },
        {
            "name": "qcy earphones",
            "value": "headset gamer sem fio"
        },
        {
            "name": "fone qcy",
            "value": "h3s qcy"
        },
        {
            "name": "wireless bluetooth headphone",
            "value": "Support Quick Charge"
        },
        {
            "name": "7 EQ Sound Effects",
            "value": "Dual Connection"
        },
        {
            "name": "Bluetooth 6.0 Headset",
            "value": "5 Modes Noise Cancellation"
        },
        {
            "name": "7 Mics with AI for Call Clarity",
            "value": "3 Situational Modes Switch"
        },
        {
            "name": "h3s over ear headphones",
            "value": "qcy headphones"
        },
        {
            "name": "bluetooth earphones",
            "value": "fone de ouvido bluetooth"
        },
        {
            "name": "wireless earphones",
            "value": "headset wireless"
        },
        {
            "name": "qcy headphones wireless",
            "value": "h3s Wireless headphones"
        },
        {
            "name": "FCC ID",
            "value": "RDR-BH25H3SA"
        }
    ],
    "package": {
        "weight_kg": 0.58,
        "length_cm": 17,
        "width_cm": 6,
        "height_cm": 22,
        "processing_days": 7
    }
}
Get product details — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40480/get+product+details?product_id=1005009940780547&country=US¤cy=USD&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the variations of a product: the properties it varies by (such as colour, size or where it ships from) with their values and images, and every SKU with its options, price, original price, discount, stock and availability.
Endpoint ID: 40481
GET https://zylalabs.com/api/15172/aliexpress+api/40481/get+product+variations
INPUT PARAMETERS

Get product variations — Endpoint Features

Object Description
product_id Required Product id (e.g. "1005009940780547"). Use the /search endpoint to list valid values.
country Optional Optional two-letter ISO code of the delivery country (e.g. "DE", defaults to "US"). Prices, shipping and stock are those for delivery to this country.
currency Optional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Optional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

product_id
country
currency
language
API EXAMPLE RESPONSE
JSON
{
    "product_id": "1005009940780547",
    "properties": [
        {
            "id": "14",
            "name": "Color",
            "values": [
                {
                    "id": "10",
                    "name": "H3S-BLACK",
                    "image": "https://ae-pic-a1.aliexpress-media.com/kf/S4a6e4a43faa2436ab48ecb1b09b9a0c4c.jpg_640x640.jpg_.webp",
                    "color": "#FF0000"
                },
                {
                    "id": "29",
                    "name": "H3S-WHITE",
                    "image": "https://ae-pic-a1.aliexpress-media.com/kf/S7c70367d9c7f4f9f8b30b148d54e4793k.jpg_640x640.jpg_.webp",
                    "color": "#FFFFFF"
                },
                {
                    "id": "173",
                    "name": "H3S-GREY",
                    "image": "https://ae-pic-a1.aliexpress-media.com/kf/S6288e490e92a42da8dcf7c57df66e68dp.jpg_640x640.jpg_.webp",
                    "color": "#0080FF"
                }
            ]
        },
        {
            "id": "200007763",
            "name": "Ships From",
            "values": [
                {
                    "id": "201336100",
                    "name": "China Mainland",
                    "image": null,
                    "color": null
                }
            ]
        }
    ],
    "skus": [
        {
            "sku_id": "12000050800828325",
            "options": [
                {
                    "property": "Color",
                    "value": "H3S-BLACK"
                },
                {
                    "property": "Ships From",
                    "value": "China Mainland"
                }
            ],
            "property_value_ids": [
                "10",
                "201336100"
            ],
            "price": 38.79,
            "original_price": 100.6,
            "currency": "USD",
            "discount_percent": 61,
            "stock": 126,
            "is_available": true,
            "image": "https://ae-pic-a1.aliexpress-media.com/kf/S4a6e4a43faa2436ab48ecb1b09b9a0c4c.jpg_640x640.jpg_.webp"
        },
        {
            "sku_id": "12000050800828326",
            "options": [
                {
                    "property": "Color",
                    "value": "H3S-WHITE"
                },
                {
                    "property": "Ships From",
                    "value": "China Mainland"
                }
            ],
            "property_value_ids": [
                "29",
                "201336100"
            ],
            "price": 38.79,
            "original_price": 100.6,
            "currency": "USD",
            "discount_percent": 61,
            "stock": 11,
            "is_available": true,
            "image": "https://ae-pic-a1.aliexpress-media.com/kf/S7c70367d9c7f4f9f8b30b148d54e4793k.jpg_640x640.jpg_.webp"
        },
        {
            "sku_id": "12000050800828327",
            "options": [
                {
                    "property": "Color",
                    "value": "H3S-GREY"
                },
                {
                    "property": "Ships From",
                    "value": "China Mainland"
                }
            ],
            "property_value_ids": [
                "173",
                "201336100"
            ],
            "price": 38.79,
            "original_price": 100.6,
            "currency": "USD",
            "discount_percent": 61,
            "stock": 3,
            "is_available": true,
            "image": "https://ae-pic-a1.aliexpress-media.com/kf/S6288e490e92a42da8dcf7c57df66e68dp.jpg_640x640.jpg_.webp"
        }
    ]
}
Get product variations — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40481/get+product+variations?product_id=1005009940780547&country=US¤cy=USD&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the shipping of a product to the delivery country: shipping method, price or free shipping, where it ships from, estimated delivery days and dates, tracking and guaranteed delivery time.
Endpoint ID: 40482
GET https://zylalabs.com/api/15172/aliexpress+api/40482/get+product+shipping
INPUT PARAMETERS

Get product shipping — Endpoint Features

Object Description
product_id Required Product id (e.g. "1005009940780547"). Use the /search endpoint to list valid values.
country Optional Optional two-letter ISO code of the delivery country (e.g. "DE", defaults to "US"). Prices, shipping and stock are those for delivery to this country.
currency Optional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Optional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

product_id
country
currency
language
API EXAMPLE RESPONSE
JSON
{
    "product_id": "1005009940780547",
    "options": [
        {
            "method": "Aliexpress Selection Standard",
            "code": "CAINIAO_FULFILLMENT_STD",
            "is_free": true,
            "price": 0,
            "currency": "USD",
            "ships_from": "China",
            "ships_from_code": "CN",
            "ships_to": "United States",
            "ships_to_code": "US",
            "delivery_days_min": 13,
            "delivery_days_max": 18,
            "delivery_date_display": "Dec. 04 - Dec. 09",
            "has_tracking": true,
            "guaranteed_delivery_days": 60
        }
    ]
}
Get product shipping — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40482/get+product+shipping?product_id=1005009940780547&country=US¤cy=USD&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the description of a product written by the seller: its full text, its images, and the text and image blocks in their order.
Endpoint ID: 40483
GET https://zylalabs.com/api/15172/aliexpress+api/40483/get+product+description
INPUT PARAMETERS

Get product description — Endpoint Features

Object Description
product_id Required Product id (e.g. "1005009940780547"). Use the /search endpoint to list valid values.
country Optional Optional two-letter ISO code of the delivery country (e.g. "DE", defaults to "US"). Prices, shipping and stock are those for delivery to this country.
currency Optional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Optional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

product_id
country
currency
language
API EXAMPLE RESPONSE
JSON
{
    "product_id": "1005009940780547",
    "text": "QCY H3S -56dB Adaptive ANC Over Ear Headphones Hi-Res LDAC Spatial Sound Wireless Earphones Bluetooth 6.0 Dual Driver 102Hrs Headset\nBefore Purchase Please Read\nQCY H3S without 3.5mm Aux port,didn't support 3.5mm audio cable.\nKey Features:\nAdaptive ANC Noise Cancellation Up to -56dB 5 Modes Noise Cancellation(Adaptive/Crowded/Commute/Indoor/Anti-Wind) 7 Mics with AI for Call Clarity & DNN Clear Call Noise Reduction Hi-Res/Hi-Res Wireless Audio & Lossless LDAC Codec (iOS devices do not support LDAC) Upgrade Transparency Mode & 60ms Low Latency 40 mm + 13 mm Dual Driver Units(40mm mid-bass driver,13mm dedicated tweeter) 360° Spatial Sound(when spatial sound mode on,LDAC will be turn off) 3 Situational Modes Switch(Gaming/Music/Movie) 102Hrs Ultra-Long Playtime & Quick Charge 7 EQ Sound Effects & Personalize More on the QCY App Wireless & Type-C Wired Connection(package without Type-C Audio Cable) Bluetooth 6.0&Dual Device Connection Ergonomic Design & 240g Feather light Comfort Fit\nSilence the Chaos,Hear the Purity.\nBuilt-in 7 microphone arrays (6 of them are ANC mics), H3S achieves an impressive -56dB noise reduction, isolating you from the outside world for a truly immersive listening experience.\nMake Every Note Heard\nThanks to 3 anti-wind noise microphones and a DNN neural network algorithm to separate the human voice from the background noises, you will never missthe important calls and information anytime and anywhere.\nUnrivaled Hi-Res Audio Clarity\nWith Hi-Res Audio certification and LDAC lossless transmission, H3S brings youstudio-quality sound with breathtaking depth and dynamics.\n40mm & 13mm Dual Driver Units\nH3S features a professional dual-driver system: A 40mm precision mid-bass driver and a 13mm dedicated tweeter for true physical crossover, delivering powerful lows, crystal-clear highs, and silky smooth extension that captures every nuance.\n360° Spatial Sound\nFeaturing a hi-resolution spatial model algorithm, QCY H3S delivers rich sound layers and a 3D listening experience.\nPersonalize Your Sound on the QCY App\nPersonalize your listening on the QCY App with tailor-made audio modes for every mood and moment.\nDesigned for All-Day Wear\nWith a carefully designed structure that evenly distributes pressure and a weight of only 240g, the H3S is incredibly lightweight but robust, offering only pure and immersive enjoyment.\nUp to 102H Pure Enjoyment\nEquipped with a 750mAh high-capacity battery, H3S delivers up to 102 hours of playtime on a single charge.\nOne Headphone to Support ALL\nFrom daily commutes to business trips, H3S is all you need for stunning sound wherever life takes you.\nSeamlessly Switch Between 2 Devices\nConnected to two devices at once, and you will never miss a beat whether on your laptop, phone, tablet or console.\nMore Ways to Stay Connected\nH3S supports both Bluetooth wireless and Type-C wired connections, giving you flexibility wherever you go. Note: (Package without Type-C Audio Cable)\nEasy to Operate\nEffortlessly achieve what you want through the maneuverable buttons and convenient instructions.\nWhat's in the Box\nQCY H3S x1 Type-C Charging Cable x 1 User Manual x1\nSpecifications:\nProduct Name: QCY H3S Bluetooth Version: 6.0 Compatible Systems: iOS / Android Bluetooth Range: 10m Water Resistance Range: IPX5 Battery Life (ANC on): 58H Battery Life (ANC off): 102H Battery Capacity: 750mAh Charging Port: Type-C\nFAQ:\nQ:What should I do if the headphones received unable to turn on? A:Confirm that the over ear headphones has power left (press the power button and check LED light is illuminated). If headphones power off,please connect it with your included USB cable and plug it into a USB power source for charging. Q:How to solve the problem that the mobile phone prompts that it cannot connect? A:Delete the pairing record on the mobile phone, and then search for pairing and connect again. Q:How to solve the problem that there is no sound when listening to music or calling? A: There is a settings icon on the right side of the Bluetooth connection name on Android phones. Click to enter, turn off the mobile phone audio and media audio, and then turn them on again. If there is still no sound, please re-pair the earphones with the mobile phone. Q: Why is there a delay in video or games? A: Affected by factors such as the use environment, network, and mobile phone Codec, there will be different degrees of delay when the mobile phone transmits audio data to the earphone. Q: How to solve the problem of stuck or intermittent sound? A:If there are a lot of Wi-Fi, 5G and 4G signals, high-power electrical appliances around, it may cause stuck and intermittent sound. Please Change the environment or re-pairing can solve the problem. Q: How do I update the version of my headphones? A: Application: Device,Settings,Firmware Upgrade. If it prompts that the upgrade cannot be made, it indicates that it is already the latest version. Q: The headphones can't connect to the APP? A: You can set the language of the application to English before connecting the headphones. Other Tips: 1. Before using the headphones, please read the manual carefully and keep it for future references. 2. The headphones need to be fully charged prior to first-time use. 3. lf the headphones are left unused for over two weeks, please recharge. 4.When spatial sound mode on,LDAC will be turn off. 5.Please use the chargers made by qualified manufacturer. 6. lf headphones fail to be found by phone, please re-turn them connectable or restore factory settings. 7.lf a program error of phone occurs, please turn off and on Bluetooth function or reboot the phone.",
    "images": [
        "https://ae-pic-a1.aliexpress-media.com/kf/S147e3fda8dad4c6e84079d5ab3ab34462.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S31a4c25f4d0d4eb8a7692e14b2fcde657.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/Se3e1b52a96db4bf58582eaadbffc24cdQ.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S693a421fa0084a55b8d1554e95a0b48aB.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S88509ff965af450c9a071030a15554c4I.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S2819244c1f044ade89ced43957503b55G.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S55bed5851b0947c298ffde7bdd89c3c7c.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/Sece51513b8ff46a1aa43a51f69219815A.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S3a477bd9572649d28e86c5f15f511a948.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S3b693ff6cea842efa796fbdd46c51538j.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S53f26803e0f840f09c983f95329be4ad4.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S2c81ae7b1a774ade85fae34ba9d4c657t.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S0fa52fcc8e4d462294b749279fd37473F.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/Sd73119ca470f4a12a25d5e3a41bfedb7q.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/Sa824b1f377c34b89b456ad743bed22daD.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S540720b97a8a436bbb746b6c678d0398g.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/S05331d68bcba4217af6d22228582fa04A.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/Scd381f80e3634d1a8fc0281a49b80879O.jpg",
        "https://ae-pic-a1.aliexpress-media.com/kf/Sb23af54059fd4c64bac280fd8b1a4f03C.jpg"
    ],
    "blocks": [
        {
            "type": "image",
            "url": "https://ae-pic-a1.aliexpress-media.com/kf/S147e3fda8dad4c6e84079d5ab3ab34462.jpg",
            "link": "https://www.aliexpress.com/item/1005012832106351.html"
        },
        {
            "type": "image",
            "url": "https://ae-pic-a1.aliexpress-media.com/kf/S31a4c25f4d0d4eb8a7692e14b2fcde657.jpg",
            "link": null
        },
        {
            "type": "text",
            "text": "QCY H3S -56dB Adaptive ANC Over Ear Headphones Hi-Res LDAC Spatial Sound Wireless Earphones Bluetooth 6.0 Dual Driver 102Hrs Headset"
        },
        {
            "type": "text",
            "text": "Before Purchase Please Read"
        },
        {
            "type": "text",
            "text": "QCY H3S without 3.5mm Aux port,didn't support 3.5mm audio cable."
        },
        {
            "type": "text",
            "text": "Key Features:"
        }
    ]
}
Get product description — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40483/get+product+description?product_id=1005009940780547&country=US¤cy=USD&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the reviews of a product: rating, number of ratings, share of positive ratings, number and share of each star rating, number of reviews per filter, ratings of aspects such as quality or fit, most mentioned phrases, and the reviews with their rating, text translated into the language asked for, original text and language, date, author country, variant bought, shipping method, images, helpful votes and additional review. 20 reviews per page.
Endpoint ID: 40484
GET https://zylalabs.com/api/15172/aliexpress+api/40484/get+product+reviews
INPUT PARAMETERS

Get product reviews — Endpoint Features

Object Description
product_id Required Product id (e.g. "1005009940780547"). Use the /search endpoint to list valid values.
filter Optional Optional review filter (defaults to "all"). Use the /general/review-filters endpoint to list valid values.
page Optional Optional page number, 20 reviews per page (defaults to 1).
country Optional Optional two-letter ISO code of the delivery country (e.g. "DE", defaults to "US"). Prices, shipping and stock are those for delivery to this country.
currency Optional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Optional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

product_id
filter
page
country
currency
language
API EXAMPLE RESPONSE
JSON
{
    "product_id": "1005009940780547",
    "rating": 4.8,
    "ratings_count": 1794,
    "positive_percent": 96.1,
    "histogram": {
        "5": {
            "count": 1586,
            "percent": 88.4
        },
        "4": {
            "count": 137,
            "percent": 7.6
        },
        "3": {
            "count": 40,
            "percent": 2.2
        },
        "2": {
            "count": 10,
            "percent": 0.6
        },
        "1": {
            "count": 21,
            "percent": 1.2
        }
    },
    "filter_counts": {
        "additional": 50,
        "local": 42,
        "with_personal": 0,
        "image": 413,
        "all": 1777
    },
    "aspects": [
        {
            "name": "User Friendly",
            "count": 683,
            "values": [
                {
                    "name": "Difficult",
                    "percent": 1
                },
                {
                    "name": "Not bad",
                    "percent": 31
                },
                {
                    "name": "Good",
                    "percent": 68
                }
            ]
        },
        {
            "name": "Quality of sound",
            "count": 571,
            "values": [
                {
                    "name": "Poor",
                    "percent": 2
                },
                {
                    "name": "Fits ok",
                    "percent": 44
                },
                {
                    "name": "Fast",
                    "percent": 54
                }
            ]
        },
        {
            "name": "Durability",
            "count": 507,
            "values": [
                {
                    "name": "Poor",
                    "percent": 1
                },
                {
                    "name": "Fits ok",
                    "percent": 49
                },
                {
                    "name": "Fast",
                    "percent": 49
                }
            ]
        }
    ],
    "mentions": [
        {
            "text": "good value for money",
            "count": 164
        },
        {
            "text": "satisfied",
            "count": 112
        },
        {
            "text": "satisfactory sound quality",
            "count": 105
        },
        {
            "text": "effective anc",
            "count": 104
        },
        {
            "text": "excellent sound",
            "count": 104
        },
        {
            "text": "comfortable fit",
            "count": 78
        }
    ],
    "total": 1777,
    "page": 1,
    "pages": 89,
    "reviews": [
        {
            "id": "60095799149322218",
            "rating": 5,
            "text": "Best value for money headset! It seems to be the best in its price range at under 40,000 won. The default EQ (after updating) is well balanced. H4 is an older version, and H3S is an upgraded new model (released in October 2025). It blocks noise and has ANC that is 78% as good as high-end products, and the function activates at about 50%. The material called \"headset\" makes the sound and external noise less noticeable. The only downside is that when the volume is high, you can hear the sound leaking from right next to you, but the price is good.",
            "original_text": "가성비 최고 해드셋! 4만원이하 가격이면 가격대 제일 좋은듯. 기본 EQ (업대이트후)가 좋게 새팅되어있음. H4는 올드 버전이고 H3S가 업글된 신모델임(25년10월 출시) 소음도 차단해주고 ANC도 고가제품에 78%는 되며,50%정도 되면 기능이 된다고 보는데 거기에 해드샛이라는 물질적인 점이 차음과 외부소음이 적게 들림. 단점은 음량이 클때 바로 옆애서 새어나오는 소리가 들리는점 빼고는 가격대 좋음.",
            "original_language": "en",
            "date": "2026-03-07",
            "author": "Y***i",
            "author_country": "US",
            "variant": "Color:H3S-BLACK Ships From:China Mainland",
            "sku_id": "12000050800828325",
            "shipping_method": "AliExpress Selection Standard Shipping for Korea",
            "images": [
                "https://ae-pic-a1.aliexpress-media.com/kf/S86d421c6cb9b4b48b94dad1904bfe9d9E.jpg"
            ],
            "helpful_votes": 0,
            "additional_review": null,
            "additional_review_days": null
        },
        {
            "id": "60096720454115253",
            "rating": 5,
            "text": "The cost-performance ratio cannot be matched by QCY. Compared to the previous H2 model, the battery life has been slightly reduced, but since it's for indoor use, it's not a big inconvenience. After adjusting the equalizer a bit, it's usable for PC use.",
            "original_text": "가성비는 qcy를 따라갈 수가 없네요. 전에 쓰던 H2에 비해서 배터리타임은 좀 짧아졌지만, 실내용이라 크게 불편하진 않습니다. 이퀄 좀 만져주니 PC용으로 쓸만해요.",
            "original_language": "en",
            "date": "2026-04-21",
            "author": "AliExpress Shopper",
            "author_country": "US",
            "variant": "Color:H3S-BLACK Ships From:China Mainland",
            "sku_id": "12000050800828325",
            "shipping_method": "AliExpress Selection Standard Shipping for Korea",
            "images": [
                "https://ae-pic-a1.aliexpress-media.com/kf/Sed21addadcbc46bb9a007c8f1ac08d7ey.jpg"
            ],
            "helpful_votes": 0,
            "additional_review": null,
            "additional_review_days": null
        }
    ]
}
Get product reviews — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40484/get+product+reviews?product_id=1005009940780547&filter=all&page=1&country=US¤cy=USD&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Returns the search suggestions for a partially typed search text, most relevant first.
Endpoint ID: 40485
GET https://zylalabs.com/api/15172/aliexpress+api/40485/get+search+autocomplete
INPUT PARAMETERS

Get search autocomplete — Endpoint Features

Object Description
query Required Text typed so far (e.g. "headph").
country Optional Optional two-letter ISO code of the delivery country (e.g. "DE", defaults to "US"). Prices, shipping and stock are those for delivery to this country.
currency Optional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Optional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

query
country
currency
language
API EXAMPLE RESPONSE
JSON
[
    "headphones",
    "headphones free shipping",
    "headphones wireless",
    "headphones wired",
    "headphone stand",
    "headphones wired for iphone",
    "headphone accessories",
    "headphones for gaming",
    "headphones for girl",
    "headphones noise canceling",
    "headphone holder"
]
Get search autocomplete — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40485/get+search+autocomplete?query=headph&country=US¤cy=USD&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Searches products by text or category, with price, delivery, rating and product attribute filters. Each product comes with its id, title, link, image, price, original price, discount and currency, rating, number sold, highlights such as free shipping or a coupon, and whether it is sponsored. Returns the total number of products found, 60 per page and at most 60 pages.
Endpoint ID: 40486
GET https://zylalabs.com/api/15172/aliexpress+api/40486/search+products
INPUT PARAMETERS

Search products — Endpoint Features

Object Description
query Optional Search text (e.g. "wireless headphones"). Required unless "category_id" is given.
category_id Optional Optional numeric category id to search in (e.g. "63705"), as returned in the "category_id" of the /product/details endpoint. Required unless "query" is given.
min_price Optional Optional minimum price, in the currency asked for.
max_price Optional Optional maximum price, in the currency asked for.
filters Optional Optional comma-separated list of filter option values (e.g. "filterCode:freeshipping,3203-4163876"). Use the /search/filters endpoint to list valid values.
sort Optional Optional sort order (defaults to "best_match"). Use the /general/sort-orders endpoint to list valid values.
page Optional Optional page number, 60 products per page (defaults to 1, at most 60).
country Optional Optional two-letter ISO code of the delivery country (e.g. "DE", defaults to "US"). Prices, shipping and stock are those for delivery to this country.
currency Optional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Optional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

query
category_id
min_price
max_price
filters
sort
page
country
currency
language
API EXAMPLE RESPONSE
JSON
{
    "total": 62949,
    "page": 1,
    "pages": 60,
    "products": [
        {
            "product_id": "3256813237589579",
            "title": "Wireless Over-Ear Headphones, Foldable Stereo, Jerry 5.3, Long Battery Life, Intelligent Noise Cancellation for Gaming Headphone",
            "url": "https://www.aliexpress.com/item/3256813237589579.html",
            "image": "https://ae-pic-a1.aliexpress-media.com/kf/A6c5e3da6f5444b119137648b24475243j.jpg",
            "price": 3.33,
            "original_price": 14.9,
            "discount_percent": 77,
            "currency": "USD",
            "price_display": "US $3.33",
            "rating": 4.9,
            "sold": 259,
            "sold_display": "259 sold",
            "highlights": [
                "Save $11.61",
                "Delivery: Nov. 30 - Dec. 05"
            ],
            "is_sponsored": false
        },
        {
            "product_id": "3256807001478042",
            "title": "BINNUNE 2.4GHz Wireless Gaming Headset with Mic for PS5 PS4 PC Mac Playstation Bluetooth Gaming Headset with Microphone",
            "url": "https://www.aliexpress.com/item/3256807001478042.html",
            "image": "https://ae-pic-a1.aliexpress-media.com/kf/S1328ed68e219482ab133025ac0448d4f0.jpg",
            "price": 27.92,
            "original_price": 86.33,
            "discount_percent": 67,
            "currency": "USD",
            "price_display": "US $27.92",
            "rating": 4.7,
            "sold": 3000,
            "sold_display": "3,000+ sold",
            "highlights": [
                "New shoppers save $58.41",
                "Top selling on AliExpress"
            ],
            "is_sponsored": false
        },
        {
            "product_id": "3256807606233309",
            "title": "Picun G2 2.4GHz Bluetooth Wireless Gaming Headset For PC PS4 PS5 Phone Switch 5ms Low Latency 7.1 Surround Wired Headset ENC Mic",
            "url": "https://www.aliexpress.com/item/3256807606233309.html",
            "image": "https://ae-pic-a1.aliexpress-media.com/kf/Sf324f5020724488eae029cf90b8f869fD.jpg",
            "price": 52.42,
            "original_price": 170.69,
            "discount_percent": 69,
            "currency": "USD",
            "price_display": "US $52.42",
            "rating": 4.7,
            "sold": 1000,
            "sold_display": "1,000+ sold",
            "highlights": [
                "New shoppers save $118.27",
                "Top selling on AliExpress"
            ],
            "is_sponsored": false
        },
        {
            "product_id": "3256807297124665",
            "title": "Lenovo LP75 Sports Wireless Earphones with Mics,Button Control, LED Power Display,Hifi Stereo Sound Bluetooth 5.3 TWS Headphones",
            "url": "https://www.aliexpress.com/item/3256807297124665.html",
            "image": "https://ae-pic-a1.aliexpress-media.com/kf/S69314da165114ce2b8c11234aeb02395C.png",
            "price": 13.19,
            "original_price": 30.33,
            "discount_percent": 56,
            "currency": "USD",
            "price_display": "US $13.19",
            "rating": 4.6,
            "sold": 10000,
            "sold_display": "10,000+ sold",
            "highlights": [
                "Top selling on AliExpress",
                "Delivery: Nov. 30 - Dec. 05"
            ],
            "is_sponsored": true
        },
        {
            "product_id": "3256812184468562",
            "title": "QCY H3 ANC Hi-Res Audio Wireless Bluetooth 5.4 Headphones Over Ear Headset 60Hrs 43dB Hybrid Active Noise Cancellation Earphone",
            "url": "https://www.aliexpress.com/item/3256812184468562.html",
            "image": "https://ae-pic-a1.aliexpress-media.com/kf/S93256dfd68ae43ee8d4d40f7ff2b76b5j.jpg",
            "price": 29.23,
            "original_price": 82.91,
            "discount_percent": 64,
            "currency": "USD",
            "price_display": "US $29.23",
            "rating": 4.9,
            "sold": 3000,
            "sold_display": "3,000+ sold",
            "highlights": [
                "New shoppers save $53.68",
                "Delivery: Nov. 30 - Dec. 05"
            ],
            "is_sponsored": false
        },
        {
            "product_id": "3256809276696571",
            "title": "Baseus EH10 NC ANC Wireless Headphones 45dB Adaptive Hybrid Noise Cancelling Headsets Hi-Res LDAC Headphone Bluetooth 6.0 80Hrs",
            "url": "https://www.aliexpress.com/item/3256809276696571.html",
            "image": "https://ae-pic-a1.aliexpress-media.com/kf/S01068676843e49518bb8b060fc4b9d7bg.jpg",
            "price": 25.4,
            "original_price": 72.61,
            "discount_percent": 65,
            "currency": "USD",
            "price_display": "US $25.40",
            "rating": 4.8,
            "sold": 5000,
            "sold_display": "5,000+ sold",
            "highlights": [
                "New shoppers save $47.21",
                "Top selling on AliExpress"
            ],
            "is_sponsored": false
        },
        {
            "product_id": "3256813404658513",
            "title": "Bluetooth Wireless Over-Ear Headphones with Soft Cushioned Ear Pads, Padded Headband & Button Controls, 5 Colors Available",
            "url": "https://www.aliexpress.com/item/3256813404658513.html",
            "image": "https://ae-pic-a1.aliexpress-media.com/kf/A00f36414490146ecb6b15ad02249da1eG.png",
            "price": 4.12,
            "original_price": 17.16,
            "discount_percent": 76,
            "currency": "USD",
            "price_display": "US $4.12",
            "rating": null,
            "sold": null,
            "sold_display": null,
            "highlights": [
                "Early bird deal, only 1 left",
                "Delivery: Nov. 30 - Dec. 05"
            ],
            "is_sponsored": false
        }
    ]
}
Search products — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40486/search+products?query=wireless headphones&sort=best_match&page=1&country=US¤cy=USD&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request
Lists the filters available for a search: deals, free shipping, Choice delivery, rating and the attributes of the products found, such as brand, colour, material or where they ship from. Each option comes with its name and the value accepted by the "filters" parameter of the /search endpoint.
Endpoint ID: 40487
GET https://zylalabs.com/api/15172/aliexpress+api/40487/get+search+filters
INPUT PARAMETERS

Get search filters — Endpoint Features

Object Description
query Optional Search text (e.g. "wireless headphones"). Required unless "category_id" is given.
category_id Optional Optional numeric category id to search in (e.g. "63705"), as returned in the "category_id" of the /product/details endpoint. Required unless "query" is given.
min_price Optional Optional minimum price, in the currency asked for.
max_price Optional Optional maximum price, in the currency asked for.
filters Optional Optional comma-separated list of filter option values (e.g. "filterCode:freeshipping,3203-4163876"). Use the /search/filters endpoint to list valid values.
country Optional Optional two-letter ISO code of the delivery country (e.g. "DE", defaults to "US"). Prices, shipping and stock are those for delivery to this country.
currency Optional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Optional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

query
category_id
min_price
max_price
filters
country
currency
language
API EXAMPLE RESPONSE
JSON
[
    {
        "name": "Deals & discounts",
        "type": "switch",
        "options": [
            {
                "name": "Black Friday",
                "value": "filterCode:bigsale"
            },
            {
                "name": "Free shipping",
                "value": "filterCode:freeshipping"
            }
        ]
    },
    {
        "name": "Delivery & service",
        "type": "switch",
        "options": [
            {
                "name": "Local+",
                "value": "filterCode:shipfrom"
            },
            {
                "name": "Choice",
                "value": "filterCode:choice_atm"
            }
        ]
    },
    {
        "name": "Quality & trust",
        "type": "switch",
        "options": [
            {
                "name": "4 stars & up",
                "value": "filterCode:4StarRating"
            }
        ]
    },
    {
        "name": "Event",
        "type": "attribute",
        "options": [
            {
                "name": "Karaoke",
                "value": "11349-4401293"
            },
            {
                "name": "Gaming",
                "value": "11349-4206462"
            },
            {
                "name": "Running",
                "value": "11349-4206470"
            },
            {
                "name": "Sleep",
                "value": "11349-4401350"
            },
            {
                "name": "Jogging",
                "value": "11349-4206464"
            },
            {
                "name": "Game",
                "value": "11349-4206461"
            },
            {
                "name": "Cycling",
                "value": "11349-4206453"
            },
            {
                "name": "Swimming",
                "value": "11349-4206475"
            }
        ]
    },
    {
        "name": "Main color",
        "type": "attribute",
        "options": [
            {
                "name": "Blue",
                "value": "3079-4148336"
            }
        ]
    },
    {
        "name": "Sensitivity",
        "type": "attribute",
        "options": [
            {
                "name": "84 dB",
                "value": "13753-4472622"
            },
            {
                "name": "85 dB",
                "value": "13753-4472627"
            },
            {
                "name": "122 dB",
                "value": "13753-4471547"
            },
            {
                "name": "111 dB",
                "value": "13753-4471473"
            },
            {
                "name": "105 dB",
                "value": "13753-4471417"
            },
            {
                "name": "99 dB",
                "value": "13753-4472703"
            },
            {
                "name": "97 dB",
                "value": "13753-4472698"
            },
            {
                "name": "125 dB",
                "value": "13753-4471553"
            },
            {
                "name": "108 dB",
                "value": "13753-4471429"
            },
            {
                "name": "123 dB",
                "value": "13753-4471549"
            },
            {
                "name": "112 dB",
                "value": "13753-4471475"
            },
            {
                "name": "118 dB",
                "value": "13753-4471494"
            },
            {
                "name": "113 dB",
                "value": "13753-4471478"
            },
            {
                "name": "98 dB",
                "value": "13753-4472701"
            },
            {
                "name": "3 dB",
                "value": "13753-4472001"
            },
            {
                "name": "100 dB",
                "value": "13753-4471368"
            },
            {
                "name": "92 dB",
                "value": "13753-4472680"
            },
            {
                "name": "32 dB",
                "value": "13753-4472091"
            },
            {
                "name": "110 dB",
                "value": "13753-4471461"
            },
            {
                "name": "128 dB",
                "value": "13753-4471561"
            },
            {
                "name": "103 dB",
                "value": "13753-4471413"
            },
            {
                "name": "96 dB",
                "value": "13753-4472695"
            },
            {
                "name": "120 dB",
                "value": "13753-4455678"
            },
            {
                "name": "42 dB",
                "value": "13753-4472223"
            },
            {
                "name": "114 dB",
                "value": "13753-4471481"
            },
            {
                "name": "102 dB",
                "value": "13753-4471408"
            }
        ]
    },
    {
        "name": "Style",
        "type": "attribute",
        "options": [
            {
                "name": "Over The Ear",
                "value": "2953-4192385"
            },
            {
                "name": "In-Ear",
                "value": "2953-4192377"
            },
            {
                "name": "Cute",
                "value": "2953-4146049"
            },
            {
                "name": "Kawaii",
                "value": "2953-4146050"
            },
            {
                "name": "Open-Ear",
                "value": "2953-4192383"
            },
            {
                "name": "Y2k",
                "value": "2953-4146061"
            }
        ]
    },
    {
        "name": "Material",
        "type": "attribute",
        "options": [
            {
                "name": "Plastic",
                "value": "3117-4151083"
            },
            {
                "name": "ABS",
                "value": "3117-4181234"
            },
            {
                "name": "Metal",
                "value": "3117-4151076"
            },
            {
                "name": "PC",
                "value": "3117-4154596"
            },
            {
                "name": "PVC",
                "value": "3117-4181042"
            },
            {
                "name": "Silica Gel",
                "value": "3117-4154594"
            },
            {
                "name": "Silicone",
                "value": "3117-4151100"
            },
            {
                "name": "TPU",
                "value": "3117-4154613"
            },
            {
                "name": "Cotton",
                "value": "3117-4151047"
            },
            {
                "name": "Wood",
                "value": "3117-4151117"
            },
            {
                "name": "Sponge",
                "value": "3117-4154617"
            },
            {
                "name": "Memory Foam",
                "value": "3117-4464518"
            }
        ]
    },
    {
        "name": "Brand",
        "type": "attribute",
        "options": [
            {
                "name": "VIKEFON",
                "value": "2250-4154428"
            },
            {
                "name": "OneOdio",
                "value": "2250-4203186"
            },
            {
                "name": "QCY",
                "value": "2250-4201530"
            },
            {
                "name": "UGREEN",
                "value": "2250-4169245"
            },
            {
                "name": "EKSA",
                "value": "2250-4202830"
            },
            {
                "name": "FiiO",
                "value": "2250-4202875"
            }
        ]
    },
    {
        "name": "Vocalism Principle",
        "type": "attribute",
        "options": [
            {
                "name": "Dynamic",
                "value": "10190-4192905"
            },
            {
                "name": "Balanced Armature",
                "value": "10190-4192903"
            },
            {
                "name": "Hybrid Technology",
                "value": "10190-4192906"
            },
            {
                "name": "Air Vocalism Principle",
                "value": "10190-4182774"
            },
            {
                "name": "Orthodynamic",
                "value": "10190-4192907"
            },
            {
                "name": "Bone Conduction",
                "value": "10190-4192904"
            }
        ]
    },
    {
        "name": "Crowd",
        "type": "attribute",
        "options": [
            {
                "name": "Athletes",
                "value": "3081-4488954"
            },
            {
                "name": "Girl",
                "value": "3081-4479967"
            },
            {
                "name": "Adult",
                "value": "3081-4477614"
            },
            {
                "name": "Children",
                "value": "3081-4185320"
            },
            {
                "name": "Kids",
                "value": "3081-4481264"
            },
            {
                "name": "Students",
                "value": "3081-4485121"
            },
            {
                "name": "Outdoor Enthusiasts",
                "value": "3081-4482911"
            },
            {
                "name": "Mountain Bikers",
                "value": "3081-4482320"
            },
            {
                "name": "Boy",
                "value": "3081-4478394"
            }
        ]
    }
]
Get search filters — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/15172/aliexpress+api/40487/get+search+filters?query=wireless headphones&country=US¤cy=USD&language=en' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the AliExpress API simply include your bearer token in the Authorization header.

Headers
Header Description
Authorization Required Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.

No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.

(Save 2 months with annual billing 🎉)

Starts at
$10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring

Overview

Online marketplace product data: search with filters, product details, SKU variations, shipping to any country, descriptions and reviews in 48 currencies and 16 languages.

General FAQs

To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.

You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.

The free trial lasts for 7 days and allows you to make up to 50 API requests.

No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.

Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.

Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

You can monitor your API usage through the response headers included with every request:

x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.

Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund


Related APIs