API di 1688
Per 1688, questa pagina distingue la ricerca per keyword, l'abbinamento dei prodotti da una singola immagine e i dettagli di una singola offerta tra search, image_search e product_detail.
Usa search per i termini di prodotto. Usa image_search per abbinare un'immagine pubblica a un massimo di cinque offerte simili su 1688. Usa product_detail per gli SKU e gli sconti per quantità di un'offerta identificata.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su alibaba1688 e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 3 funzionalità
- Da $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
- Operatività nelle ultime 24 ore 99%
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- 99%
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di 1688: 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.000 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | 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. | $2.78 per 1.000 richieste | Buono · operatività 100% |
Dettagli del prodottoproduct_detail | 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. | $1.39 per 1.000 richieste | Buono · operatività 99% |
Ricerca prodotti per immagine nella piattaformaimage_search | Confronta una foto di prodotto in image_url con le offerte di 1688 e ottieni fino a cinque offerte all'ingrosso simili con titolo, prezzo in CNY, ordine minimo, venditore e link. | $5.56 per 1.000 richieste | Buono · operatività 98% |
Cosa accetta ogni azione di API di 1688?
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.000 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca 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é | keyword | city, max_price, min_price, sort | Valori del catalogo: defaultLimit=20, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | $2.78 per 1.000 richieste | id · url · title · text · price_min · price_max · currency · min_order_quantity · order_count · repurchase_rate · category · city · province · supplier_name · is_out_of_stock · supports_dropship · images · supplier_type · supplier_years · supplier_shop_url · supplier_composite_score · sold_count_text · service_tags · product_badges · rating · rating_scale · review_count · positive_rate · sold_count · sold_display · want_buy_count · stock · unit · category_path · video_url · winport_url · supplier_fans · supplier_founded_year · price_tiers · specs · description_images · coupons · promotion_details · service_details · purchase_limits · mix_wholesale · supports_mix · review_tags · refund_rate · review_negative_count · review_neutral_count · review_with_photo_count · review_with_text_count · supplier_stats · supplier_scores · supplier_metric_tags · supplier_rank · supplier_industry_belt · supplier_certification · supplier_verification_tags · supplier_inspection_report_url · supplier_videos · supplier_address · supplier_coordinates · supplier_main_category · customization · shipping · unit_weight_kg · platform |
product_detailDettagli del prodotto 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 | url | — | — | $1.39 per 1.000 richieste | id · url · title · text · price_min · price_max · currency · price_tiers · min_order_quantity · stock · sold_count · category · unit · supplier_name · supplier_fans · supplier_founded_year · supplier_type · supplier_favorited_count · supports_dropship · supports_sampling · is_out_of_stock · skus · images · description_images · video_url · specs · rating · rating_scale · review_count · positive_rate · sold_display · want_buy_count · category_path · services · promotions · customization_supported · winport_url · city · province · supplier_years · package_dimensions · coupons · promotion_details · service_details · purchase_limits · mix_wholesale · supports_mix · review_tags · refund_rate · review_negative_count · review_neutral_count · review_with_photo_count · review_with_text_count · supplier_stats · supplier_scores · supplier_metric_tags · supplier_rank · supplier_industry_belt · supplier_certification · supplier_verification_tags · supplier_inspection_report_url · supplier_videos · supplier_address · supplier_coordinates · supplier_main_category · customization · shipping · unit_weight_kg · platform |
image_searchRicerca prodotti per immagine nella piattaforma Confronta una foto di prodotto in | image_url | — | Valori del catalogo: defaultLimit=5, maxLimit=5. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | $5.56 per 1.000 richieste | id · url · title · price · currency · min_order_quantity · order_count · supplier_name · image_url · rank · platform |
Cosa significano i parametri search di API di 1688?
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.
keywordObbligatorio- 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.
cityFacoltativo- 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_priceFacoltativo- 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_priceFacoltativo- 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.
sortFacoltativo- 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 ammessi:
popularprice_ascprice_descrelevance
Cosa significano i parametri product_detail di API di 1688?
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.
urlObbligatorio- 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.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
Cosa significano i parametri image_search di API di 1688?
Confronta una foto di prodotto in image_url con le offerte di 1688 e ottieni fino a cinque offerte all'ingrosso simili con titolo, prezzo in CNY, ordine minimo, venditore e link. rank è l'ordine di corrispondenza per questa immagine, non una classifica di vendite.
image_urlObbligatorio- Per image_search, fornisci l'URL HTTPS pubblico di un'immagine di prodotto. L'azione invia una sola immagine, restituisce al massimo cinque offerte corrispondenti di 1688 e non include l'arricchimento con dettagli o SKU.1688 Open Platform: trovare prodotti simili a partire da un'immagine — La piattaforma aperta di 1688 documenta una ricerca ufficiale di prodotti simili che accetta un URL di immagine o il contenuto dell'immagine. Questa fonte stabilisce solo l'oggetto immagine-prodotto a livello di piattaforma; il limite di una sola immagine, il massimo di cinque risultati, l'allowlist della risposta, l'addebito e il comportamento di consegna di EveryInfra sono definiti dalla documentazione pubblicata da EveryInfra. · Verificato
Come usare l'API di 1688
- 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":"alibaba1688","action":"search","params":{"keyword":"<keyword>"}}'
Guide su API di 1688
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 1688
Cosa posso ottenere con l'API di 1688?
Imposta platform su alibaba1688. Il catalogo attuale elenca ricerca, dettagli del prodotto e ricerca prodotti per immagine nella piattaforma. Questi nomi di azione identificano oggetti o viste diversi di 1688; non sono modalità di ricerca intercambiabili.
1688 ha un'API ufficiale?
La 1688 Open Platform di Alibaba è pensata per i fornitori di software che sviluppano strumenti per i venditori di 1688 e per gli acquirenti che si riforniscono o fanno dropshipping da 1688, come strumenti per la pubblicazione di prodotti, la gestione degli ordini e gli acquisti cross-border; elenca oltre 1.600 fornitori partner.
Fonti ufficiali: 1688 Open Platform · Verificato
Mi serve un account sviluppatore o una chiave API di 1688?
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 1688, richiedere l'accesso alle API di 1688 né accedere con un account 1688; le azioni restituiscono solo dati pubblici di 1688.
Quanto costa l'API di 1688 per 1.000 richieste?
Da $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 1688?
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. Invialo come keyword all'interno di params.
Quali campi può restituire search di 1688?
Il suo schema dichiarato include title, text, price_min e price_max. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di 1688 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.