AliExpress API

API ID 15172

Dados de produtos de marketplace online: pesquisa com filtros, detalhes do produto, variações de SKU, envio para qualquer país, descrições e avaliações em 48 moedas e 16 idiomas

Documentação da API

Endpoints

Requisição
Lista as moedas aceitas pelo parâmetro "currency", cada uma com seu código e nome
Endpoint ID: 40476
GET https://zylalabs.com/api/15172/aliexpress+api/40476/get+currencies
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
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"
    }
]
Obter moedas — TRECHOS DE CÓDIGO

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


    
Requisição
Lista os idiomas aceitos pelo parâmetro "language", cada um com seu código e nome
Endpoint ID: 40477
GET https://zylalabs.com/api/15172/aliexpress+api/40477/get+languages
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
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"
    }
]
Obter idiomas — TRECHOS DE CÓDIGO

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


    
Requisição
Lista os valores aceitos pelo parâmetro "sort" do endpoint /search
Endpoint ID: 40478
GET https://zylalabs.com/api/15172/aliexpress+api/40478/get+sort+orders
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
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"
    }
]
Obter ordens de classificação — TRECHOS DE CÓDIGO

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


    
Requisição
Lista os valores aceitos pelo parâmetro "filter" do endpoint /product/reviews
Endpoint ID: 40479
GET https://zylalabs.com/api/15172/aliexpress+api/40479/get+review+filters
PARÂMETROS DE ENTRADA

Solicitações gratuitas de teste restantes: 3 de 3.

Este endpoint não requer parâmetros de entrada.

RESPOSTA DE EXEMPLO DA API
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"
    }
]
Obter filtros de avaliação — TRECHOS DE CÓDIGO

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


    
Requisição
Retorna os detalhes de um produto título categoria faixa de preço preço original desconto e moeda estoque quantidade mínima de pedido avaliação número de avaliações número de unidades vendidas número de itens na lista de desejos loja com seu id nome id do vendedor e indicador de classificação máxima imagens vídeo especificações e tamanho e peso da embalagem
Endpoint ID: 40480
GET https://zylalabs.com/api/15172/aliexpress+api/40480/get+product+details
PARÂMETROS DE ENTRADA

Obter detalhes do produto — Recursos do endpoint

Objeto Descrição
product_id Obrigatório Product id (e.g. "1005009940780547"). Use the /search endpoint to list valid values.
country Opcional 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 Opcional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Opcional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

product_id
country
currency
language
RESPOSTA DE EXEMPLO DA API
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
    }
}
Obter detalhes do produto — TRECHOS DE CÓDIGO

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' 


    
Requisição
Lista as variações de um produto: as propriedades pelas quais varia (como cor, tamanho ou local de envio) com seus valores e imagens e cada SKU com suas opções, preço, preço original, desconto, estoque e disponibilidade
Endpoint ID: 40481
GET https://zylalabs.com/api/15172/aliexpress+api/40481/get+product+variations
PARÂMETROS DE ENTRADA

Obter variações do produto — Recursos do endpoint

Objeto Descrição
product_id Obrigatório Product id (e.g. "1005009940780547"). Use the /search endpoint to list valid values.
country Opcional 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 Opcional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Opcional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

product_id
country
currency
language
RESPOSTA DE EXEMPLO DA API
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"
        }
    ]
}
Obter variações do produto — TRECHOS DE CÓDIGO

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' 


    
Requisição
Retorna o envio de um produto para o país de entrega: método de envio, preço ou frete grátis, local de envio, dias e datas estimados de entrega, rastreamento e prazo de entrega garantido
Endpoint ID: 40482
GET https://zylalabs.com/api/15172/aliexpress+api/40482/get+product+shipping
PARÂMETROS DE ENTRADA

Obter envio do produto — Recursos do endpoint

Objeto Descrição
product_id Obrigatório Product id (e.g. "1005009940780547"). Use the /search endpoint to list valid values.
country Opcional 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 Opcional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Opcional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

product_id
country
currency
language
RESPOSTA DE EXEMPLO DA API
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
        }
    ]
}
Obter envio do produto — TRECHOS DE CÓDIGO

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' 


    
Requisição
Retorna a descrição de um produto escrita pelo vendedor: o texto completo, as imagens e os blocos de texto e imagem na ordem em que aparecem.
Endpoint ID: 40483
GET https://zylalabs.com/api/15172/aliexpress+api/40483/get+product+description
PARÂMETROS DE ENTRADA

Obter descrição do produto — Recursos do endpoint

Objeto Descrição
product_id Obrigatório Product id (e.g. "1005009940780547"). Use the /search endpoint to list valid values.
country Opcional 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 Opcional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Opcional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

product_id
country
currency
language
RESPOSTA DE EXEMPLO DA API
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:"
        }
    ]
}
Obter descrição do produto — TRECHOS DE CÓDIGO

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' 


    
Requisição
Retorna as avaliações de um produto: classificação, número de classificações, porcentagem de classificações positivas, número e porcentagem de cada classificação por estrelas, número de avaliações por filtro, classificações de aspectos como qualidade ou caimento, frases mais mencionadas e as avaliações com sua classificação, texto traduzido para o idioma solicitado, texto original e idioma, data, país do autor, variante comprada, método de envio, imagens, votos de utilidade e avaliação adicional 20 avaliações por página
Endpoint ID: 40484
GET https://zylalabs.com/api/15172/aliexpress+api/40484/get+product+reviews
PARÂMETROS DE ENTRADA

Obtenha avaliações de produtos — Recursos do endpoint

Objeto Descrição
product_id Obrigatório Product id (e.g. "1005009940780547"). Use the /search endpoint to list valid values.
filter Opcional Optional review filter (defaults to "all"). Use the /general/review-filters endpoint to list valid values.
page Opcional Optional page number, 20 reviews per page (defaults to 1).
country Opcional 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 Opcional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Opcional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

product_id
filter
page
country
currency
language
RESPOSTA DE EXEMPLO DA API
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
        }
    ]
}
Obtenha avaliações de produtos — TRECHOS DE CÓDIGO

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' 


    
Requisição
Retorna as sugestões de pesquisa para um texto de pesquisa parcialmente digitado, por ordem de relevância
Endpoint ID: 40485
GET https://zylalabs.com/api/15172/aliexpress+api/40485/get+search+autocomplete
PARÂMETROS DE ENTRADA

Obter preenchimento automático da pesquisa — Recursos do endpoint

Objeto Descrição
query Obrigatório Text typed so far (e.g. "headph").
country Opcional 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 Opcional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Opcional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

query
country
currency
language
RESPOSTA DE EXEMPLO DA API
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"
]
Obter preenchimento automático da pesquisa — TRECHOS DE CÓDIGO

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' 


    
Requisição
Pesquisa produtos por texto ou categoria com filtros de preço entrega avaliação e atributos do produto Cada produto vem com seu id título link imagem preço preço original desconto e moeda avaliação quantidade vendida destaques como frete grátis ou cupom e indicação se é patrocinado Retorna o número total de produtos encontrados 60 por página e no máximo 60 páginas
Endpoint ID: 40486
GET https://zylalabs.com/api/15172/aliexpress+api/40486/search+products
PARÂMETROS DE ENTRADA

Pesquisar produtos — Recursos do endpoint

Objeto Descrição
query Opcional Search text (e.g. "wireless headphones"). Required unless "category_id" is given.
category_id Opcional 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 Opcional Optional minimum price, in the currency asked for.
max_price Opcional Optional maximum price, in the currency asked for.
filters Opcional Optional comma-separated list of filter option values (e.g. "filterCode:freeshipping,3203-4163876"). Use the /search/filters endpoint to list valid values.
sort Opcional Optional sort order (defaults to "best_match"). Use the /general/sort-orders endpoint to list valid values.
page Opcional Optional page number, 60 products per page (defaults to 1, at most 60).
country Opcional 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 Opcional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Opcional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

query
category_id
min_price
max_price
filters
sort
page
country
currency
language
RESPOSTA DE EXEMPLO DA API
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
        }
    ]
}
Pesquisar produtos — TRECHOS DE CÓDIGO

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' 


    
Requisição
Lista os filtros disponíveis para uma pesquisa: ofertas, frete grátis, entrega Choice, avaliação e os atributos dos produtos encontrados, como marca, cor, material ou local de envio Cada opção vem com seu nome e o valor aceito pelo parâmetro "filters" do endpoint /search
Endpoint ID: 40487
GET https://zylalabs.com/api/15172/aliexpress+api/40487/get+search+filters
PARÂMETROS DE ENTRADA

Obter filtros de pesquisa — Recursos do endpoint

Objeto Descrição
query Opcional Search text (e.g. "wireless headphones"). Required unless "category_id" is given.
category_id Opcional 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 Opcional Optional minimum price, in the currency asked for.
max_price Opcional Optional maximum price, in the currency asked for.
filters Opcional Optional comma-separated list of filter option values (e.g. "filterCode:freeshipping,3203-4163876"). Use the /search/filters endpoint to list valid values.
country Opcional 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 Opcional Optional currency code (e.g. "EUR", defaults to "USD"). Use the /general/currencies endpoint to list valid values.
language Opcional Optional language code of the texts (e.g. "de", defaults to "en"). Use the /general/languages endpoint to list valid values.

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

query
category_id
min_price
max_price
filters
country
currency
language
RESPOSTA DE EXEMPLO DA API
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"
            }
        ]
    }
]
Obter filtros de pesquisa — TRECHOS DE CÓDIGO

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' 


    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a AliExpress API basta incluir seu token Bearer no cabeçalho Authorization.

Cabeçalhos
Cabeçalho Descrição
Authorization Obrigatório Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.

(Economize 2 meses com cobrança anual 🎉)

A partir de
$10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Visão Geral

Dados de produtos de marketplace online: pesquisa com filtros, detalhes do produto, variações de SKU, envio para qualquer país, descrições e avaliações em 48 moedas e 16 idiomas

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas