API 1688 Dettagli del prodotto
POST
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- 99%
- Tempo medio nelle ultime 24 ore
- 56.45 s
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Buono
Ultime 24 ore
Ultimi 30 giorni
Recupera un'offerta di 1688 dal link al prodotto o dall'offerId numerico, con prezzi a scaglioni, quantità minima d'ordine, stock, varianti, specifiche, immagini e informazioni sul venditore. In price_tiers il prezzo unitario scende all'aumentare della quantità, e un campo variante mancante non significa che quella variante sia esaurita.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su alibaba1688 e action impostato su product_detail. Prezzo $1.39 per 1.000 richieste ($0.001389 per chiamata). Le chiamate non riuscite e i risultati vuoti non vengono addebitati. Sincrona. Per i job più lenti, aggiungi "mode": "async" al corpo della richiesta, recupera il job_id ed esegui il polling.
La funzionalità 1688 Product details legge tutti i dati pubblici di un prodotto all'ingrosso: fascia di prezzo e prezzi a scaglioni, quantità minima d'ordine e unità di prezzo, disponibilità e vendite, dettagli delle varianti, valutazione e tasso di recensioni positive, immagini e nome, tipo, anno di fondazione, follower e preferiti del fornitore, oltre a indicare se offre campioni e dropshipping. Usala per capire se conviene acquistare da questo fornitore, per valutare un acquisto e confrontare i fornitori.
url accetta un link a un prodotto 1688, un testo di condivisione con un solo link a un prodotto o un ID offerta numerico; le home page dei negozi e le pagine di ricerca vengono rifiutate. Leggi i prezzi con price_tiers, dove il prezzo unitario scende all'aumentare della quantità. positive_rate è una frazione da 0 a 1, non una percentuale. Opzioni, prezzi e disponibilità in skus compaiono solo quando la piattaforma li indica, quindi un valore mancante non significa che il prodotto sia esaurito.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint 1688 Dettagli del prodotto di EveryInfra (alibaba1688/product_detail).
Come funziona l'endpoint:
- Richiesta: POST https://api.everyinfra.com/api/v1/social con l'header Authorization: Bearer <chiave API>. Leggi la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY e non scriverla mai direttamente nel codice.
- Nel corpo della richiesta imposta platform su alibaba1688 e action su product_detail, e inserisci i parametri in params.
- Parametri obbligatori:
- url: Per product_detail, usa l'URL di un prodotto su detail.1688.com o m.1688.com, un messaggio di condivisione che contenga esattamente un URL di prodotto oppure un offerId numerico.
- Restituisce un oggetto. Campi principali: id, url, title, text, price_min (Limite inferiore della fascia di prezzo), price_max (Limite superiore della fascia di prezzo), currency, price_tiers (Prezzi a scaglioni: il prezzo unitario…), min_order_quantity (Quantità minima d'ordine (MOQ)), stock (Scorte di magazzino), sold_count (Unità vendute), category (Nome della categoria nella tassonomia p…); 68 campi in totale, elenco completo su https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688.
- Esempio di corpo della richiesta:
{
"platform": "alibaba1688",
"action": "product_detail",
"params": {
"url": "https://detail.1688.com/offer/873514490218.html"
}
}
- Prezzo: $1.39 per 1.000 richieste; le richieste non riuscite e i risultati vuoti non vengono addebitati.
- Per decine o centinaia di target, aggiungi "mode": "async" al corpo: ricevi subito un job_id ed esegui il polling su GET https://api.everyinfra.com/api/v1/jobs/{job_id} per ottenere il risultato.
- In caso di 422, correggi la richiesta usando i nomi dei parametri e i valori consentiti suggeriti nell'errore; in caso di 429 o 503, attendi il tempo indicato da Retry-After e riprova.
Prima di scrivere il codice, chiedimi quali target mi servono, quanti, quali campi e quale formato di output voglio; poi conferma con me il piano e il costo indicativo.Parametri della richiesta
#| Nome | Posizione | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|---|
Authorization | header | string | Sì | - | Bearer seguito dalla tua chiave API. Creala nella console; non inserirla mai in un URL o in un repository di codice. |
platform | body | string | Sì | alibaba1688 | Identificativo della piattaforma, valore fisso. |
action | body | string | Sì | product_detail | Identificativo della funzionalità, valore fisso. |
url | body.params | string | Sì | - | Per product_detail, usa l'URL di un prodotto su detail.1688.com o m.1688.com, un messaggio di condivisione che contenga esattamente un URL di prodotto oppure un offerId numerico. Un link di condivisione qr.1688.com è accettato solo se rimanda in modo sicuro alla pagina di un prodotto. Le pagine dei negozi e delle ricerche vengono rifiutate. |
Esempi di codice
#bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "alibaba1688",
"action": "product_detail",
"params": {
"url": "https://detail.1688.com/offer/873514490218.html"
}
}'Definizione OpenAPI (JSON)Gli esempi leggono la chiave dalla variabile d'ambiente EVERYINFRA_API_KEY; il codice copiato non contiene mai la tua chiave.
Esempio di risposta
#Acquisita il October 13, 2026 at 04:57 (UTC) chiamando questa API con i parametri dell'esempio di codice qui sopra. results e count sono la risposta reale di quella chiamata, da cui sono state rimosse le informazioni personali (nomi, handle, avatar, link ai profili, recapiti). id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{ "id": "req_…", "platform": "alibaba1688", "action": "product_detail", "results": { "id": "•••", "url": "https://detail.1688.com/offer/873514490218.html", "title": "跨境专供Pro6蓝牙耳机真无线入耳式超长续航tws运动无线蓝牙耳机", "price_min": 7.1, "price_max": 13.8, "currency": "CNY", "min_order_quantity": 2, "stock": 7682692, "sold_count": 16813, "category": "蓝牙耳机", "unit": "条", "supplier_name": "深圳高耳基科技有限公司", "supplier_fans": "582", "supplier_type": "normal_factory", "supplier_favorited_count": 582, "supports_dropship": { "enabled": false, "consignPrice": null, "consignPriceTiers": [], "channels": [], "channelDetails": [], "protections": [], "downstreamPerformance": null, "metrics": { "orders30d": null, "orders7d": null, "pickupRate48h": null, "pickupRate24h": null, "distributorCount": null, "downstreamStoreCount": null, "publishDate": null } }, "supports_sampling": false, "is_out_of_stock": false, "skus": [ { "id": "•••", "name": "Pro6蓝牙耳机 紫色", "options": { "颜色": "Pro6蓝牙耳机 紫色" }, "price": 7.6, "original_price": 7.6, "stock": 665434, "available": true, "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ngwdIg1fNlJ87ZHWL_!!2218564053995-0-cib.jpg" }, { "id": "•••", "name": "八代蓝牙耳机简配", "options": { "颜色": "八代蓝牙耳机简配" }, "price": 9.6, "original_price": 9.6, "stock": 666024, "available": true }, { "id": "•••", "name": "Pro6蓝牙耳机 粉色", "options": { "颜色": "Pro6蓝牙耳机 粉色" }, "price": 7.6, "original_price": 7.6, "stock": 664567, "available": true, "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01VHBm431fNlJGJw3Jm_!!2218564053995-0-cib.jpg" } ], "images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01RrMK531fNlLKVri2p_!!2218564053995-0-cib.jpg", "https://cbu01.alicdn.com/img/ibank/O1CN01oiS7FO1fNlJFcPVcJ_!!2218564053995-0-cib.jpg", "https://cbu01.alicdn.com/img/ibank/O1CN019hrirk1fNlJGpWQke_!!2218564053995-0-cib.jpg" ], "description_images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01xDu8VE1fNlOMt4i8Z_!!2218564053995-0-cib.jpg", "https://cbu01.alicdn.com/img/ibank/O1CN01mTmUSS1fNlONCMZWr_!!2218564053995-0-cib.jpg", "https://cbu01.alicdn.com/img/ibank/O1CN01myoX5I1fNlONcSew0_!!2218564053995-0-cib.jpg" ], "video_url": "https://cloud.video.taobao.com/play/u/2218564053995/p/2/e/6/t/1/482069395965.mp4", "specs": [ { "name": "芯片类型", "value": "中科蓝讯" }, { "name": "功能", "value": "防水,降噪,呼吸灯,超长续航,通话功能,语音控制,支持音乐,数显屏幕,电竞低延迟" }, { "name": "续航时间", "value": "0-4小时" } ], "rating": 4.7, "review_count": 20, "positive_rate": 0.95, "sold_display": "已售2.2万+件", "want_buy_count": 127, "category_path": "数码、电脑 > 手机配件 > 蓝牙耳机", "services": [ "7天无理由退货", "晚发必赔" ], "winport_url": "https://winport.1688.com/page/index.html?memberId=b2b-2218564053995870c8&_tabId_=index&upstreamSource=od&offerId=873514490218", "platform": "1688", "rating_scale": 5 }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Campi della risposta
#I dati di business si trovano in results. La tabella elenca i campi che un record può contenere; i valori che la piattaforma non mostra non vengono mai inventati.
| Campo | Significato |
|---|---|
id | ID univoco del record sulla piattaforma. È univoco solo all'interno di una piattaforma; gli ID possono ripetersi tra piattaforme diverse. |
url | Link al record sulla piattaforma. |
title | Titolo. null quando la piattaforma non prevede titoli (ad esempio post di solo testo). |
text | Testo del contenuto senza HTML, restituito per intero e mai troncato (su alcune piattaforme i risultati degli elenchi contengono solo un estratto; lo indicano le note sui campi della piattaforma). |
price_min | Limite inferiore della fascia di prezzo. |
price_max | Limite superiore della fascia di prezzo. |
currency | Codice valuta del prezzo (ad esempio CNY, USD). Se price è presente ma currency è null, non dare per scontata una valuta. |
price_tiers | Prezzi a scaglioni: il prezzo unitario diminuisce all'aumentare della quantità ordinata. Leggi ogni scaglione insieme alla sua quantità minima. |
min_order_quantity | Quantità minima d'ordine (MOQ). È la prima soglia negli acquisti all'ingrosso su 1688: controllala prima di tutto il resto. |
stock | Scorte di magazzino. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
sold_count | Unità vendute. |
category | Nome della categoria nella tassonomia propria della piattaforma, non normalizzato tra piattaforme. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
unit | Unità a cui si riferisce il prezzo (pezzo, articolo, cartone e così via). |
supplier_name | Nome del fornitore. |
supplier_fans | Numero di follower del fornitore. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
supplier_founded_year | Anno di fondazione del fornitore. |
supplier_type | Modello di business del fornitore (ad es. produttore, grossista). |
supplier_favorited_count | Numero di volte in cui il fornitore è stato aggiunto ai preferiti. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
supports_dropship | Indica se il fornitore spedisce singole unità per tuo conto (dropshipping). È un filtro chiave per vendere senza tenere magazzino. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
supports_sampling | Indica se il fornitore offre campioni. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
is_out_of_stock | Indica se il prodotto è esaurito. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
skus | Dettagli delle varianti, se disponibili. Opzioni, prezzo, scorte e disponibilità di ogni riga vengono restituiti solo quando i dati della piattaforma li riportano; un valore mancante non significa che la variante sia esaurita. Nei dettagli del prodotto questi campi delle varianti possono essere vuoti con una chiamata sincrona: weight_g, length_cm, width_cm, height_cm, volume_cm3, image_url, original_price; se ti servono, usa una chiamata asincrona. |
images | Link alle immagini principali del prodotto nell'ordine in cui compaiono nella pagina; in product_detail alcune schede prodotto includono anche le immagini delle varianti (SKU), mentre le immagini dell'area della descrizione si trovano in description_images. Assente quando non sono presenti immagini. |
description_images | Elenco degli URL delle immagini della descrizione dettagliata, nell'ordine originale della scheda prodotto; null quando la scheda prodotto non ne ha. |
video_url | URL del video del prodotto, se la scheda prodotto ne ha uno. |
specs | Tabella delle specifiche del prodotto: elenco di coppie {name, value} (ad es. Materiale: TPU). Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
rating | Valutazione complessiva del prodotto (1-5). Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
rating_scale | Valore massimo della valutazione nella stessa riga: 5 per le scale a cinque stelle, 10 per le scale a dieci punti. Presente solo quando la riga contiene una valutazione. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
review_count | Numero totale di recensioni. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
positive_rate | Tasso di recensioni positive espresso come frazione da 0 a 1 (0.999 = 99,9%). Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
sold_display | Vendite come visualizzate in origine (testo originale in cinese, ad es. 100k+ venduti); per il valore numerico usa sold_count. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
want_buy_count | Numero di acquirenti che hanno indicato di voler acquistare il prodotto (un segnale della domanda di approvvigionamento). Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
category_path | Percorso completo della categoria con i nomi dei livelli in cinese (ad es. Digitale > Accessori per telefoni > Custodie per telefoni, nella lingua originale). Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
services | Etichette dei servizi della scheda prodotto (ad es. spedizione gratuita per i resi, indennizzo per ritardo nella consegna). Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
promotions | Nomi delle promozioni attualmente attive. |
customization_supported | Indica se il fornitore supporta la personalizzazione (grafica personalizzata, campionatura). Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
winport_url | Link alla vetrina 1688 del fornitore. |
city | Nome della città nella lingua della piattaforma, non normalizzato. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
province | Provincia in cui ha sede il fornitore. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
supplier_years | Anni di presenza del fornitore sulla piattaforma 1688. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
package_dimensions | Mantiene il significato attribuito dalla piattaforma |
coupons | Mantiene il significato attribuito dalla piattaforma |
promotion_details | Mantiene il significato attribuito dalla piattaforma |
service_details | Dettagli delle garanzie di servizio: code (codice del servizio), name, description (la regola), rule_url (pagina della regola). services / service_tags forniscono solo i nomi. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
purchase_limits | Mantiene il significato attribuito dalla piattaforma |
mix_wholesale | Mantiene il significato attribuito dalla piattaforma |
supports_mix | Mantiene il significato attribuito dalla piattaforma |
review_tags | Tag delle impressioni degli acquirenti: [{tag, count}], ad esempio “tessuto morbido” ×2. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
refund_rate | Mantiene il significato attribuito dalla piattaforma |
review_negative_count | Mantiene il significato attribuito dalla piattaforma |
review_neutral_count | Mantiene il significato attribuito dalla piattaforma |
review_with_photo_count | Numero di recensioni con foto; null significa che il dato non è fornito, non che vale 0. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
review_with_text_count | Numero di recensioni con testo; null significa che il dato non è fornito, non che vale 0. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
supplier_stats | Profilo del fornitore (solo le chiavi con un valore): employee_count, plant_area_sqm (superficie dello stabilimento in m²), plant_type (ad esempio, fabbrica di proprietà), equipment_count (attrezzature principali), product_count (prodotti in vendita), repeat_rate (tasso di acquirenti abituali, 0-1), repeat_buyer_count_text / cross_border_buyer_count_text (acquirenti abituali e transfrontalieri così come mostrati, ad esempio 300+), response_rate (0-1), positive_review_rate (0-1), fulfillment_rate (0-1), certificate_count / certificates / management_certificates (numero di certificati, nomi e certificazioni dei sistemi di gestione), patent_count, oem_mode (OEM/ODM), own_brands (marchi propri così come mostrati), brand_count, partner_brand, is_major_brand_partner (fornisce grandi marchi), scale_tier (fascia dimensionale), honors. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
supplier_scores | Mantiene il significato attribuito dalla piattaforma |
supplier_metric_tags | Mantiene il significato attribuito dalla piattaforma |
supplier_rank | Mantiene il significato attribuito dalla piattaforma |
supplier_industry_belt | Certificazione del distretto industriale: description (ad esempio, un commerciante di punta di un distretto regionale dell'abbigliamento certificato da 1688), link_url (pagina della certificazione). Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
supplier_certification | Audit di terze parti sulla fabbrica o sull'azienda: agency (codice dell'ente di audit, ad esempio sgs o tuv), report_number (numero del report così come mostrato), report_url (pagina del report). Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
supplier_verification_tags | Mantiene il significato attribuito dalla piattaforma |
supplier_inspection_report_url | Mantiene il significato attribuito dalla piattaforma |
supplier_videos | Mantiene il significato attribuito dalla piattaforma |
supplier_address | Indirizzo del fornitore così come mostrato. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
supplier_coordinates | Posizione del fornitore: {longitude, latitude}. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
supplier_main_category | Categoria principale del fornitore. Nei dettagli del prodotto il valore può essere vuoto con una chiamata sincrona; se ti serve, usa una chiamata asincrona. |
customization | Mantiene il significato attribuito dalla piattaforma |
shipping | Mantiene il significato attribuito dalla piattaforma |
unit_weight_kg | Mantiene il significato attribuito dalla piattaforma |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
FAQ
#Come si leggono i prezzi a scaglioni?
#price_tiers elenca il prezzo unitario per ogni fascia di quantità; il prezzo scende all'aumentare della quantità acquistata. min_order_quantity è la quantità minima d'ordine e unit l'unità di prezzo. Per stimare il costo, individua la fascia in cui rientra la quantità che prevedi di acquistare.
Come distinguo un produttore da una società commerciale?
#supplier_type indica se il fornitore è un produttore o una società commerciale. Leggilo insieme a supplier_founded_year, supplier_fans e supplier_favorited_count per valutare da quanto tempo opera il fornitore e quanta attenzione riceve.
Una variante senza dati sulla disponibilità è esaurita?
#Non necessariamente. Opzioni, prezzi, scorte e disponibilità in skus vengono restituiti solo quando la piattaforma li indica, quindi l'assenza di un dato non significa che la variante sia esaurita. Controlla is_out_of_stock per il prodotto nel suo complesso. In una chiamata sincrona, stock, positive_rate, supports_dropship e altri campi (categoria, recensioni, servizi, profilo del fornitore, dimensioni e peso delle varianti; l'elenco dei campi li riporta tutti) possono essere vuoti; usa una chiamata asincrona quando ti servono.
Errori e addebiti
#- 401
- Chiave mancante o non valida.
- 402
- Saldo insufficiente. Effettua prima una ricarica.
- 422
- Nome o valore del parametro non valido. Correggilo seguendo i suggerimenti dell'errore. Nessun addebito.
- 429
- Raggiunto il limite di richieste al minuto. Attendi il tempo indicato da Retry-After, poi riprova.
- 503
- Impossibile completare. L'importo trattenuto torna sul tuo saldo. Se l'esito è incerto, verificalo prima di riprovare.
- Risposta 200 vuota
- Nessun dato. Nessun addebito.
Riferimenti ufficiali
#Usati solo per verificare oggetti e terminologia. Non implicano alcuna autorizzazione o approvazione di EveryInfra da parte della piattaforma.
- 1688: prodotti, specifiche e quantità minime d'ordine ↗
La documentazione di 1688 sugli acquisti distingue offerId del prodotto, specId della specifica e quantità d'acquisto, e convalida separatamente la quantità minima d'ordine. Questi termini sono citati qui solo a scopo esplicativo; questo endpoint non crea né mostra in anteprima ordini d'acquisto.
Verificato il 2026-09-04