API 1688 Ricerca prodotti per immagine nella piattaforma
Stato di salute dell'API
- Operatività nelle ultime 24 ore
- 98%
- Tempo medio nelle ultime 24 ore
- 45.56 s
- Buono / normale
- Disponibile
- Limitato
- Quasi del tutto inattivo
Ultime 24 ore
Ultimi 30 giorni
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.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su alibaba1688 e action impostato su image_search. Prezzo $5.56 per 1.000 richieste ($0.005556 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 ricerca per immagine di 1688 cerca su 1688 prodotti simili a partire da un'immagine e restituisce per ogni corrispondenza titolo, prezzo, quantità minima d'ordine, numero di ordini, nome del fornitore, immagine e posizione nell'elenco delle corrispondenze. Usala per capire se un prodotto è presente su 1688, chi lo vende e a che prezzo: risalire all'origine di un prodotto finito o della foto di un concorrente, confrontare i prezzi tra marketplace o trovare fornitori alternativi.
Passa in image_url un link HTTPS pubblicamente raggiungibile a un'immagine; ogni chiamata cerca una sola immagine. I risultati sono candidati dall'aspetto simile, non necessariamente lo stesso articolo, quindi verifica i dettagli prima di ordinare. rank è solo la posizione in questo elenco di corrispondenze, non una classifica di vendita. Per varianti complete, disponibilità e informazioni sul fornitore, passa l'url di un risultato a 1688 Product details.
Prompt per l'AI
#Aiutami a scrivere uno script di raccolta dei dati con l'endpoint 1688 Ricerca prodotti per immagine nella piattaforma di EveryInfra (alibaba1688/image_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 image_search, e inserisci i parametri in params.
- Parametri obbligatori:
- image_url: 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.
- Parametri facoltativi:
- limit: Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 5. Se lo ometti, viene applicato il valore predefinito; una chiamata può restituire meno righe. (predefinito: 5)
- Restituisce un elenco di record. Campi principali di ogni record: id, url, title, price, currency, min_order_quantity (Quantità minima d'ordine (MOQ)), order_count (Numero di ordini), supplier_name (Nome del fornitore), image_url, rank (Posizione dell'offerta nell'elenco dell…).
- Esempio di corpo della richiesta:
{
"platform": "alibaba1688",
"action": "image_search",
"params": {
"image_url": "https://cbu01.alicdn.com/img/ibank/15418323391_1847764777.jpg"
}
}
- Prezzo: $5.56 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ì | image_search | Identificativo della funzionalità, valore fisso. |
image_url | body.params | string | Sì | - | 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. |
limit | body.params | integer (1–5) | No | 5 | Numero massimo di righe da restituire in questa chiamata: un intero da 1 a 5. 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
#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": "image_search",
"params": {
"image_url": "https://cbu01.alicdn.com/img/ibank/15418323391_1847764777.jpg"
}
}'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
#{ "id": "req_…", "platform": "alibaba1688", "action": "image_search", "results": [ { "id": "•••", "url": "https://detail.1688.com/offer/1087685101407.html", "title": "pet toy Five pointed star toy TPR Star Relief Molar ring", "price": 1.5, "currency": "CNY", "min_order_quantity": 50, "order_count": 0, "supplier_name": "徐州经济技术开发区俊飒宠物用品经营部", "image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01YZTAXwRx8CF1chua_!!2223051725283-0-cib.jpg", "rank": 1, "platform": "1688" }, { "id": "•••", "url": "https://detail.1688.com/offer/1006441717931.html", "title": "狗狗玩具宠物发声玩具耐咬小狗幼犬狗狗磨牙洁齿训练搪胶玩具批发", "price": 1.5, "currency": "CNY", "min_order_quantity": 2, "order_count": 6771, "supplier_name": "东阳市嘉瑞宝宠物用品有限公司", "image_url": "https://cbu01.alicdn.com/O1CN01ltOurZ202KnOTWxaR_!!2216996446791-0-cib.jpg", "rank": 2, "platform": "1688" } ], "count": 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). |
price | Prezzo come numero senza simbolo di valuta; vedi currency. |
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. |
supplier_name | Nome del fornitore. |
image_url | Link all'immagine. Le funzionalità con più immagini possono restituire un array image_urls. |
rank | Posizione dell'offerta nell'elenco delle corrispondenze per questa immagine; indica solo l'ordine di questo risultato, non una classifica di vendita. |
platform | Identificativo della piattaforma di origine, uguale a platform nella richiesta (ad esempio xiaohongshu, tiktok). |
FAQ
#Che tipo di immagine funziona?
#Un solo link HTTPS pubblicamente raggiungibile che punti direttamente all'immagine del prodotto; ogni chiamata cerca una sola immagine. Non funzionano immagini protette da login, indirizzi di pagine web e file locali. Una foto nitida del prodotto su sfondo uniforme di solito produce corrispondenze più precise.
rank è una classifica di vendita?
#No. rank riflette solo l'ordine delle corrispondenze restituite per questa immagine; non è una classifica di vendita e non garantisce che il primo risultato sia lo stesso articolo. Usa order_count per valutare quanto vende un prodotto.
Come ottengo i dettagli del fornitore di una corrispondenza?
#I risultati della ricerca per immagine non includono varianti complete, disponibilità e dettagli del fornitore. Passa l'url di un risultato a 1688 Product details per ottenere prezzi a scaglioni, ordine minimo, dettagli delle varianti e profilo del fornitore.
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 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 il 2026-09-21