API 1688 Ricerca
POST
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- 100%
- Tempo medio nelle ultime 24 ore
- 37.34 s
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Buono
Ultime 24 ore
Ultimi 30 giorni
Elenca le offerte all'ingrosso di 1688 per una keyword di prodotto, con fascia di prezzo, quantità minima d'ordine, numero di ordini, tasso di riacquisto e dettagli del venditore. Né l'ordinamento né order_count attestano le vendite esatte o un preventivo definitivo.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su alibaba1688 e action impostato su search. Prezzo $2.78 per 1.000 richieste ($0.002778 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.
1688 Search trova prodotti all'ingrosso per keyword e restituisce per ciascuno titolo, fascia di prezzo, quantità minima d'ordine, unità vendute, tasso di riacquisto, nome del fornitore, località, tipo di attività e anni sulla piattaforma, stato delle scorte e se supporta il dropshipping. Usala per vedere quali fornitori trattano un prodotto e, a grandi linee, quali sono condizioni d'ordine e prezzi: il primo passo per il sourcing, il confronto tra fornitori o la scelta dei prodotti per un negozio in dropshipping.
Delimita il prezzo con min_price e max_price, filtra per città con city e ordina con sort (pertinenza, più venduti o prezzo crescente o decrescente). Leggi prima min_order_quantity, perché è la prima soglia negli acquisti all'ingrosso; repurchase_rate e supplier_composite_score ti permettono di selezionare i fornitori prima di aprire qualsiasi prodotto. I filtri di prezzo non garantiscono che ogni variante e fascia di quantità rientri nell'intervallo; contano i prezzi a scaglioni nei dettagli del prodotto.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint 1688 Ricerca di EveryInfra (alibaba1688/search).
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 search, e inserisci i parametri in params.
- Parametri obbligatori:
- keyword: Specifica il termine di ricerca per i prodotti all'ingrosso di 1688 (ad esempio tazze termiche o scatole di cartone). Usa termini di prodotto, non nomi di negozi o offerId.
- Parametri facoltativi:
- city: Filtra le query sugli articoli all'ingrosso di 1688 in base al testo del nome della città.
- max_price: Filtra gli articoli all'ingrosso per prezzo unitario massimo, come valore numerico. Sono ammessi i decimali.
- min_price: Filtra gli articoli all'ingrosso per prezzo unitario minimo, come valore numerico. Sono ammessi i decimali.
- sort: Ordina gli articoli della ricerca per relevance (predefinito per search), popular, price_asc o price_desc. (valori consentiti: popular / price_asc / price_desc / relevance)
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 20)
- Restituisce un elenco di record. Campi principali di ogni record: id, url, title, text, price_min (Limite inferiore della fascia di prezzo), price_max (Limite superiore della fascia di prezzo), currency, min_order_quantity (Quantità minima d'ordine (MOQ)), order_count (Numero di ordini), repurchase_rate (Tasso di riacquisto), category (Nome della categoria nella tassonomia p…), city (Nome della città nella lingua della pia…); 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": "search",
"params": {
"keyword": "不锈钢保温杯"
}
}
- Prezzo: $2.78 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ì | search | Identificativo della funzionalità, valore fisso. |
keyword | body.params | string | Sì | - | Specifica il termine di ricerca per i prodotti all'ingrosso di 1688 (ad esempio tazze termiche o scatole di cartone). Usa termini di prodotto, non nomi di negozi o offerId; quantità minime d'ordine e prezzi per fascia vengono restituiti nei dettagli degli articoli. |
city | body.params | string | No | - | Filtra le query sugli articoli all'ingrosso di 1688 in base al testo del nome della città. Questo filtro non riflette la località dell'account, non modifica gli indirizzi dei venditori restituiti e non garantisce un filtro persistente nelle richieste di dettaglio di un singolo prodotto. |
max_price | body.params | number | No | - | Filtra gli articoli all'ingrosso per prezzo unitario massimo, come valore numerico. Sono ammessi i decimali; quando una chiamata ripiega sul filtro per yuan interi, vengono arrotondati per eccesso (145.98 diventa 146), quindi l'intervallo può solo allargarsi. Funziona insieme a min_price per delimitare l'intervallo di prezzo, non le quantità d'ordine per fascia, e potrebbe non coprire tutte le varianti SKU o le fasce di sconto per volume. |
min_price | body.params | number | No | - | Filtra gli articoli all'ingrosso per prezzo unitario minimo, come valore numerico. Sono ammessi i decimali; quando una chiamata ripiega sul filtro per yuan interi, vengono arrotondati per difetto (39.81 diventa 39), quindi l'intervallo può solo allargarsi. Questo parametro imposta criteri sugli articoli, non quantità minime d'ordine né limiti di spesa API, e i prezzi per fascia restituiti variano in base al volume dell'ordine. |
sort | body.params | string (enum) | No | - | Ordina gli articoli della ricerca per relevance (predefinito per search), popular, price_asc o price_desc. I criteri di ordinamento non garantiscono la presenza nel payload di dati di vendita esatti o di importi totali delle transazioni.Valori consentitipopularprice_ascprice_descrelevance |
limit | body.params | integer (1–100) | No | 20 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 100. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. I valori più alti restituiscono 422 prima di qualsiasi addebito. |
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": "search",
"params": {
"keyword": "不锈钢保温杯"
}
}'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); l'elenco conserva i primi 2. id, billing e quota cambiano a ogni chiamata, quindi ne viene mostrata solo la struttura.
json
{ "id": "req_…", "platform": "alibaba1688", "action": "search", "results": [ { "id": "•••", "url": "https://detail.1688.com/offer/901095512547.html", "title": "跨境美式太空壶304不锈钢双层真空保温杯大容量运动水壶登山水壶", "price_min": 12.5, "currency": "CNY", "order_count": 33, "repurchase_rate": 20, "city": "永康市", "province": "浙江", "supplier_name": "永康市钛霖杯业有限公司", "images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01LbpPbm2B0StIPXCWn_!!2219521848276-0-cib.jpg" ], "supplier_type": "生产加工", "supplier_years": 2, "supplier_shop_url": "https://shop81l5635to8463.1688.com", "sold_count_text": "已售1200+件", "service_tags": [ "退货包运费", "先采后付", "回头率54%" ], "product_badges": [ "先采后付" ], "platform": "1688" }, { "id": "•••", "url": "https://detail.1688.com/offer/1080785307425.html", "title": "新款彩色304不锈钢保温杯 便携手提弹跳盖户外便携运动水杯定 制", "price_min": 24, "currency": "CNY", "min_order_quantity": 1, "order_count": 49, "repurchase_rate": 14, "city": "金华市", "province": "浙江", "supplier_name": "永康市大表哥工贸有限公司", "images": [ "https://cbu01.alicdn.com/img/ibank/O1CN01NbBs3QLcV7L3thOC_!!2217763939489-0-cib.jpg" ], "supplier_type": "生产加工", "supplier_years": 3, "supplier_shop_url": "https://15727971454.1688.com", "sold_count_text": "已售500+件", "service_tags": [ "退货包运费", "先采后付", "回头率67%" ], "product_badges": [ "7×24H响应", "先采后付" ], "platform": "1688" } ], "count": 20, "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. |
min_order_quantity | Quantità minima d'ordine (MOQ). È la prima soglia negli acquisti all'ingrosso su 1688: controllala prima di tutto il resto. |
order_count | Numero di ordini. |
repurchase_rate | Tasso di riacquisto. Uno dei segnali più affidabili della qualità di un fornitore su 1688. |
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. |
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_name | Nome del fornitore. |
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. |
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. |
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. |
supplier_type | Modello di business del fornitore (ad es. produttore, grossista). |
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. |
supplier_shop_url | Link al negozio del fornitore. |
supplier_composite_score | Punteggio complessivo del servizio del fornitore (1-5). |
sold_count_text | Vendite come visualizzate in origine nelle righe di ricerca (testo originale in cinese, ad es. 100+ venduti su tutta la rete). |
service_tags | Elenco delle etichette dei servizi nelle righe di ricerca. |
product_badges | Elenco dei badge del prodotto nelle righe di ricerca (ad es. risposta 7×24H). |
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_count | Unità vendute. |
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. |
stock | Scorte di magazzino. 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). |
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. |
video_url | URL del video del prodotto, se la scheda prodotto ne ha uno. |
winport_url | Link alla vetrina 1688 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. |
price_tiers | Prezzi a scaglioni: il prezzo unitario diminuisce all'aumentare della quantità ordinata. Leggi ogni scaglione insieme alla sua quantità minima. |
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. |
description_images | Elenco degli URL delle immagini della descrizione dettagliata, nell'ordine originale della scheda prodotto; null quando la scheda prodotto non ne ha. |
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
#Perché i prezzi filtrati non corrispondono alla pagina del prodotto?
#I prezzi di 1688 sono a scaglioni: il prezzo unitario dipende da quante unità acquisti. min_price e max_price filtrano sul prezzo mostrato nella ricerca, senza garantire che ogni variante o scaglione di quantità rientri nell'intervallo. Il preventivo effettivo sono i prezzi a scaglioni nei dettagli del prodotto.
Su cosa filtra city?
#Filtra i prodotti in base al testo della città. Non è la località del tuo account e non cambia gli indirizzi dei fornitori restituiti; per sapere da dove partono le merci, leggi city e province di ogni risultato.
Come trovo fornitori che fanno dropshipping?
#Tieni i risultati in cui supports_dropship è true, poi controlla min_order_quantity e is_out_of_stock per capire se puoi ordinare piccole quantità e se l'articolo è disponibile. Un repurchase_rate alto e un valore elevato di supplier_years sono segnali utili che il fornitore consegna con costanza.
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.