API di AliExpress
Recupera prodotti cross-border, varianti dettagliate, distribuzioni delle valutazioni e recensioni degli acquirenti per confrontare la merce e raccogliere il feedback dei consumatori.
Localizza le ricerche con il codice del paese di destinazione e la valuta di visualizzazione; tieni presente che recuperare una variante non garantisce che resti disponibile per l'acquisto.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su aliexpress e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 6 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di AliExpress: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $1.39 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Sfoglia le schede prodotto di AliExpress per una keyword di prodotto. | $1.39 per 1.000 richiesteOgni 50 righe valgono una chiamata | Normale |
Dettagliprofile | Apri il link di un articolo AliExpress e ottieni la pagina prodotto in JSON. | Normale | |
Variantsvariants | Elenca le varianti e gli SKU di un prodotto AliExpress, con proprietà, colore, immagine e prezzo di ogni opzione quando la scheda prodotto li mostra. | Normale | |
Recensionireviews | Raccogli il feedback degli acquirenti su un prodotto AliExpress, con valutazione in stelle, paese, variante acquistata, metodo di spedizione, voti di utilità e foto. | Normale | |
Riepilogo delle valutazioniratings | Leggi la valutazione media in stelle e il numero totale di recensioni di un prodotto AliExpress. | Normale | |
Dettagli del prodottoproduct_detail | Recupera la pagina prodotto completa di un articolo AliExpress: prezzo e sconto, unità vendute, valutazione, spedizione, varianti, attributi, stock totale e informazioni sul negozio. | Normale |
Cosa accetta ogni azione di API di AliExpress?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Sfoglia le schede prodotto di AliExpress per una keyword di prodotto. Confronta il prezzo con il prezzo originale, lo sconto, gli ordini, la valutazione, la località di spedizione e il venditore. I filtri coprono prezzo minimo, valutazione minima in stelle e ordinamento. I dati descrivono ogni scheda prodotto, non la domanda o il margine. | keyword | min_price, min_rating, sort | Valori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | $1.39 per 1.000 richiesteOgni 50 righe valgono una chiamata | product_id · title · url · price · original_price · currency · discount · rating · rating_scale · orders_count · review_count · image_url · ships_from · seller_name · category · is_top_rated · free_shipping · images · search_rank · seller_rating · seller_url · platform · tags |
profileDettagli Apri il link di un articolo AliExpress e ottieni la pagina prodotto in JSON. Ottieni titolo, prezzi, valuta, valutazione, unità vendute, spedizione, dettagli del negozio e indicatori di disponibilità. Nonostante il nome, | url | country, currency | — | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform | |
variantsVariants Elenca le varianti e gli SKU di un prodotto AliExpress, con proprietà, colore, immagine e prezzo di ogni opzione quando la scheda prodotto li mostra. Una combinazione mancante non significa che sia esaurita, e l'elenco non è un registro completo dello stock. | url | country, currency | — | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform | |
reviewsRecensioni Raccogli il feedback degli acquirenti su un prodotto AliExpress, con valutazione in stelle, paese, variante acquistata, metodo di spedizione, voti di utilità e foto. Quando | url | sort | Valori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | review_id · text · rating · rating_scale · posted_at · country · author · sku_info · helpful_count · logistics · product_id · is_anonymous · unhelpful_count · language · original_text · is_translated · review_labels · sku_id · platform · images | |
ratingsRiepilogo delle valutazioni Leggi la valutazione media in stelle e il numero totale di recensioni di un prodotto AliExpress. La ripartizione per numero di stelle e le percentuali di recensioni positive, neutre e negative sono temporaneamente non disponibili. Usa | url | — | — | average_star · total_reviews · positive_rate · neutral_rate · negative_rate · five_star · four_star · three_star · two_star · one_star · platform | |
product_detailDettagli del prodotto Recupera la pagina prodotto completa di un articolo AliExpress: prezzo e sconto, unità vendute, valutazione, spedizione, varianti, attributi, stock totale e informazioni sul negozio. | url | country, currency | — | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
Cosa significano i parametri search di API di AliExpress?
Sfoglia le schede prodotto di AliExpress per una keyword di prodotto. Confronta il prezzo con il prezzo originale, lo sconto, gli ordini, la valutazione, la località di spedizione e il venditore. I filtri coprono prezzo minimo, valutazione minima in stelle e ordinamento. I dati descrivono ogni scheda prodotto, non la domanda o il margine.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statokeywordObbligatorio- Specifica la query di ricerca dei prodotti (ad esempio wireless earbuds) per ottenere elenchi di schede prodotto. Passa parole chiave di ricerca, non ID venditore; per dettagli del prodotto, varianti e recensioni usa gli URL degli articoli.
min_priceFacoltativo- Imposta la soglia numerica di prezzo minimo degli articoli nelle ricerche, per escludere quelli più economici. È un filtro sul prezzo degli articoli, non una percentuale di sconto né un budget per le richieste API; la valuta dei risultati dipende dai metadati della ricerca.
min_ratingFacoltativo- Filtra le ricerche di articoli per valutazione minima in stelle, su una scala numerica da 0 a 5 (ad esempio 4.5). Il parametro considera la valutazione complessiva del prodotto, non il numero di recensioni, la percentuale di feedback positivi o i punteggi delle singole recensioni.
sortFacoltativo- Ordina i risultati dell'azione con i valori consentiti. Per search, le opzioni sono relevance (predefinito), popular, price_asc, price_desc e top_rated (con supporto dei valori legacy default, orders, rating). Per reviews, le opzioni sono relevance (predefinito) e newest, che ordina per data di invio della recensione e non per data di pubblicazione della scheda prodotto. ratings non accetta alcun ordinamento.Valori ammessi:
popularprice_ascprice_descrelevancetop_rated
Cosa significano i parametri profile di API di AliExpress?
Apri il link di un articolo AliExpress e ottieni la pagina prodotto in JSON. Ottieni titolo, prezzi, valuta, valutazione, unità vendute, spedizione, dettagli del negozio e indicatori di disponibilità. Nonostante il nome, profile descrive il prodotto, non il profilo di un acquirente. I dati di stock non garantiscono l'inventario.
urlObbligatorio- Specifica l'articolo AliExpress di destinazione tramite URL completo (ad esempio https://www.aliexpress.com/item/<item_id>.html). Usa url con profile per ottenere i metadati del prodotto, con variants per gli SKU, con reviews o ratings per i riepiloghi dei feedback, oppure con product_detail (che accetta anche un ID articolo numerico).
countryFacoltativo- Il codice del paese o della regione, ad esempio US, in base al quale profile, variants e product_detail recuperano il prodotto (valore predefinito: US; viene convertito in maiuscolo). Determina la vista regionale dell'articolo; non cambia il paese del tuo account né l'indirizzo di spedizione di un ordine reale.
currencyFacoltativo- La valuta dei prezzi degli articoli restituiti da profile, variants e product_detail, ad esempio USD (predefinito USD, convertito in maiuscolo). Cambia solo i prezzi mostrati e non ha nulla a che fare con l'addebito delle chiamate API di EveryInfra.
Cosa significano i parametri variants di API di AliExpress?
Elenca le varianti e gli SKU di un prodotto AliExpress, con proprietà, colore, immagine e prezzo di ogni opzione quando la scheda prodotto li mostra. Una combinazione mancante non significa che sia esaurita, e l'elenco non è un registro completo dello stock.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica l'articolo AliExpress di destinazione tramite URL completo (ad esempio https://www.aliexpress.com/item/<item_id>.html). Usa url con profile per ottenere i metadati del prodotto, con variants per gli SKU, con reviews o ratings per i riepiloghi dei feedback, oppure con product_detail (che accetta anche un ID articolo numerico).AliExpress: attributi SKU e attributi generali delle categorie — Gli endpoint di consultazione degli attributi dell'open platform distinguono, all'interno di una categoria, gli attributi SKU dagli attributi generali, e forniscono campi come nome dell'attributo, valore dell'attributo e obbligatorietà del campo. Questa spiegazione serve solo a chiarire la terminologia delle varianti di AliExpress e non indica che questo endpoint supporti la pubblicazione di schede prodotto né che garantisca la restituzione di tutte le combinazioni della categoria. · Verificato
countryFacoltativo- Il codice del paese o della regione, ad esempio US, in base al quale profile, variants e product_detail recuperano il prodotto (valore predefinito: US; viene convertito in maiuscolo). Determina la vista regionale dell'articolo; non cambia il paese del tuo account né l'indirizzo di spedizione di un ordine reale.
currencyFacoltativo- La valuta dei prezzi degli articoli restituiti da profile, variants e product_detail, ad esempio USD (predefinito USD, convertito in maiuscolo). Cambia solo i prezzi mostrati e non ha nulla a che fare con l'addebito delle chiamate API di EveryInfra.
Cosa significano i parametri reviews di API di AliExpress?
Raccogli il feedback degli acquirenti su un prodotto AliExpress, con valutazione in stelle, paese, variante acquistata, metodo di spedizione, voti di utilità e foto. Quando is_translated è true, text è una traduzione e original_text contiene le parole originali di chi ha scritto la recensione.
urlObbligatorio- Specifica l'articolo AliExpress di destinazione tramite URL completo (ad esempio https://www.aliexpress.com/item/<item_id>.html). Usa url con profile per ottenere i metadati del prodotto, con variants per gli SKU, con reviews o ratings per i riepiloghi dei feedback, oppure con product_detail (che accetta anche un ID articolo numerico).
sortFacoltativo- Ordina i risultati dell'azione con i valori consentiti. Per search, le opzioni sono relevance (predefinito), popular, price_asc, price_desc e top_rated (con supporto dei valori legacy default, orders, rating). Per reviews, le opzioni sono relevance (predefinito) e newest, che ordina per data di invio della recensione e non per data di pubblicazione della scheda prodotto. ratings non accetta alcun ordinamento.Valori ammessi:
newestrelevance
Cosa significano i parametri ratings di API di AliExpress?
Leggi la valutazione media in stelle e il numero totale di recensioni di un prodotto AliExpress. La ripartizione per numero di stelle e le percentuali di recensioni positive, neutre e negative sono temporaneamente non disponibili. Usa reviews per le singole recensioni.
urlObbligatorio- Specifica l'articolo AliExpress di destinazione tramite URL completo (ad esempio https://www.aliexpress.com/item/<item_id>.html). Usa url con profile per ottenere i metadati del prodotto, con variants per gli SKU, con reviews o ratings per i riepiloghi dei feedback, oppure con product_detail (che accetta anche un ID articolo numerico).
Cosa significano i parametri product_detail di API di AliExpress?
Recupera la pagina prodotto completa di un articolo AliExpress: prezzo e sconto, unità vendute, valutazione, spedizione, varianti, attributi, stock totale e informazioni sul negozio. country e currency impostano il contesto regionale, e sold_text è il valore arrotondato mostrato sulla pagina, non un conteggio esatto.
urlObbligatorio- Specifica l'articolo AliExpress di destinazione tramite URL completo (ad esempio https://www.aliexpress.com/item/<item_id>.html). Usa url con profile per ottenere i metadati del prodotto, con variants per gli SKU, con reviews o ratings per i riepiloghi dei feedback, oppure con product_detail (che accetta anche un ID articolo numerico).
countryFacoltativo- Il codice del paese o della regione, ad esempio US, in base al quale profile, variants e product_detail recuperano il prodotto (valore predefinito: US; viene convertito in maiuscolo). Determina la vista regionale dell'articolo; non cambia il paese del tuo account né l'indirizzo di spedizione di un ordine reale.
currencyFacoltativo- La valuta dei prezzi degli articoli restituiti da profile, variants e product_detail, ad esempio USD (predefinito USD, convertito in maiuscolo). Cambia solo i prezzi mostrati e non ha nulla a che fare con l'addebito delle chiamate API di EveryInfra.
Come usare l'API di AliExpress
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"aliexpress","action":"search","params":{"keyword":"<keyword>"}}'
Guide su API di AliExpress
Esempi pratici e metodi basati su queste azioni. Verifica prima azioni, parametri e campi attuali in questa pagina: esempi e limiti di un articolo non sostituiscono il catalogo aggiornato.
Monetizzare lo scraping dei prezzi: come costruire un prodotto di monitoraggio dei prezzi con un abbonamento che i merchant vorranno rinnovare
Perché i merchant pagano per il monitoraggio dei prezzi e perché disdicono l'abbonamento. Analizziamo modalità di consegna dei dati sui prezzi, unità di fatturazione e accettazione dei piloti attraverso abbinamento dei prodotti, elenchi di eccezioni e flussi di approvazione dei prezzi.
Leggi l'articoloPrimi passi con l'API unificata per i dati: dal catalogo delle funzionalità al primo risultato utilizzabile
Accedi ai dati di più piattaforme con platform, action e params: leggi il catalogo delle funzionalità, completa richieste minime, gestisci task asincroni, risultati parziali e addebiti, e crea record di dati tracciabili.
Leggi l'articoloErrori delle API, restituzione dei crediti e riconciliazione: come verificare l'addebito netto di una richiesta
Separa task, tentativi di chiamata, stati di consegna ed eventi del portafoglio per gestire rifiuti prima dell'addebito, risultati vuoti e restituzioni parziali di crediti senza doppi conteggi, con esempi offline basati su interi.
Leggi l'articoloDomande sull'API di AliExpress
Cosa posso ottenere con l'API di AliExpress?
Imposta platform su aliexpress. Il catalogo attuale elenca ricerca, dettagli, variants, recensioni, riepilogo delle valutazioni e more. Questi nomi di azione identificano oggetti o viste diversi di AliExpress; non sono modalità di ricerca intercambiabili.
AliExpress ha un'API ufficiale?
AliExpress Open Platform offre API dedicate ai venditori, utilizzabili solo con i negozi che autorizzano la tua app e relative ai loro prodotti e ordini; agli affiliati, che devono prima registrarsi come publisher di AliExpress Portals e ottenere l'approvazione del proprio profilo sviluppatore; e ai dropshipper.
Fonti ufficiali: «AliExpress Open Platform: Global APIs overview» · «AliExpress Open Platform: affiliate quick start» · Verificato
Mi serve un account sviluppatore o una chiave API di AliExpress?
No. Le richieste passano da EveryInfra con una chiave API EveryInfra: registrati, crea una chiave nella console e inviala come Authorization: Bearer <API_KEY>. Non devi registrare un'app nel portale per sviluppatori di AliExpress, richiedere l'accesso alle API di AliExpress né accedere con un account AliExpress; le azioni restituiscono solo dati pubblici di AliExpress.
Quanto costa l'API di AliExpress per 1.000 richieste?
$1.39 per 1.000 richieste, a seconda dell'azione; il prezzo di ogni azione è indicato nella tabella di questa pagina e nel catalogo pubblico. Non c'è alcun abbonamento: ricarichi un saldo in USD e paghi per chiamata, e le chiamate non riuscite e i risultati vuoti non vengono addebitati.
Quale input avvia la richiesta search di AliExpress?
Specifica la query di ricerca dei prodotti (ad esempio wireless earbuds) per ottenere elenchi di schede prodotto. Passa parole chiave di ricerca, non ID venditore; per dettagli del prodotto, varianti e recensioni usa gli URL degli articoli. Invialo come keyword all'interno di params.
Quali campi può restituire search di AliExpress?
Il suo schema dichiarato include product_id, title, price e original_price. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di AliExpress rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.