API di Xianyu
Xianyu (Goofish) è il marketplace dell'usato di Alibaba. search restituisce gli annunci che corrispondono a una keyword. item_detail legge un batch di annunci tramite ID numerico dell'elemento o link a un elemento di goofish.com, con una riga per annuncio.
Gli annunci dell'usato vengono venduti o rimossi rapidamente, quindi ogni riga è uno snapshot acquisito al momento della richiesta. Nei risultati di ricerca, want_count proviene dalla scheda dell'annuncio ed è null quando la scheda non lo mostra. item_detail aggiunge le condizioni su una scala di dieci punti, il numero di visualizzazioni e salvataggi, tutte le foto, la descrizione e la percentuale di recensioni positive del venditore. Gli annunci che non è possibile leggere vengono restituiti in missed e non vengono addebitati.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su xianyu e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 2 funzionalità
- $5.56 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
- Operatività nelle ultime 24 ore 100%
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- 100%
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Xianyu: 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: $5.56 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Sfoglia le schede di prodotti usati su Xianyu per una frase di ricerca, fino a 50 per chiamata. | Buono · operatività 100% | |
Dettagli della scheda prodottoitem_detail | Ottieni le schede complete di Xianyu per 1-20 ID elemento o link goofish.com. | Normale |
Cosa accetta ogni azione di API di Xianyu?
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: $5.56 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Sfoglia le schede di prodotti usati su Xianyu per una frase di ricerca, fino a 50 per chiamata. Ottieni prezzo, città, numero di interessati, tag, indicatore d'asta e livello di affidabilità del venditore. I termini in cinese e i codici modello corrispondono meglio ai titoli dei venditori. Un | keyword | — | Valori del catalogo: defaultLimit=20, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | item_id · url · title · price · original_price · currency · city · image_url · want_count · tags · category_id · free_shipping · is_auction · has_video · posted_at · seller_id · seller_name · seller_avatar_url · seller_credit_label · platform | |
item_detailDettagli della scheda prodotto Ottieni le schede complete di Xianyu per 1-20 ID elemento o link goofish.com. Ottieni descrizione, punteggio delle condizioni, spese di spedizione, località e statistiche dettagliate del venditore. | urls | — | — | item_id · url · title · text · price · original_price · currency · shipping_fee · condition_level · status · quantity · want_count · view_count · collect_count · sold_count · province · city · category_id · image_url · images · posted_at · seller_id · seller_name · seller_url · seller_item_count · seller_sold_count · seller_good_review_rate · seller_reply_rate_24h · district · division_id · lat · lng · poi_name · poi_id · seller_avatar_url · seller_city · seller_bio · seller_joined_at · seller_last_seen · seller_zhima_verified · seller_zhima_level · seller_zhima_level_code · seller_credit_level · seller_identity_tags · seller_other_items · platform |
Cosa significano i parametri search di API di Xianyu?
Sfoglia le schede di prodotti usati su Xianyu per una frase di ricerca, fino a 50 per chiamata. Ottieni prezzo, città, numero di interessati, tag, indicatore d'asta e livello di affidabilità del venditore. I termini in cinese e i codici modello corrispondono meglio ai titoli dei venditori. Un want_count null significa che la scheda non lo mostrava, non che sia zero.
keywordObbligatorio- La frase di ricerca Xianyu per
search, da 1 a 100 caratteri. I termini in cinese e i numeri di modello trovano più spesso corrispondenza nei titoli pubblicati dai venditori rispetto alle traduzioni in inglese. Non è un ID articolo né il nome di un venditore.
Cosa significano i parametri item_detail di API di Xianyu?
Ottieni le schede complete di Xianyu per 1-20 ID elemento o link goofish.com. Ottieni descrizione, punteggio delle condizioni, spese di spedizione, località e statistiche dettagliate del venditore. condition_level usa una scala da 10 punti. sold_count è null quando Xianyu lo nasconde. Le schede che non è possibile leggere vengono rimborsate.
urlsObbligatorio- Per
item_detail, un array di 1–20 schede prodotto Xianyu: ogni voce è un ID articolo numerico (l'item_idrestituito dasearch) o un linkhttps://www.goofish.com/item?id=<digits>, e ogni scheda prodotto può comparire una sola volta. L'addebito è per scheda prodotto e le schede prodotto che non è possibile leggere vengono rimborsate. I link brevi di condivisione dell'app non sono accettati.Alibaba Open Platform: ID degli articoli e classificazione del loro stato su Xianyu — L'API di consultazione degli articoli che Alibaba riserva ai partner ISV autorizzati di Xianyu identifica una singola scheda prodotto tramite il suo ID numerico di articolo Xianyu e classifica la condizione con stuff_status: 100 indica nuovo di zecca, 95 indica nuovo al 95% e -1 indica quasi nuovo. Le chiamate richiedono un'autorizzazione all'interno dell'ambiente partner di Alibaba; la fonte conferma solo l'identificatore e la terminologia sulla condizione e non significa che EveryInfra usi questa API né che possa leggere ogni campo di qualsiasi scheda prodotto. · Verificato
Come usare l'API di Xianyu
- 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":"xianyu","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Xianyu
Cosa posso ottenere con l'API di Xianyu?
Imposta platform su xianyu. Il catalogo attuale elenca ricerca e dettagli della scheda prodotto. Questi nomi di azione identificano oggetti o viste diversi di Xianyu; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Xianyu?
La frase di ricerca Xianyu per search, da 1 a 100 caratteri. I termini in cinese e i numeri di modello trovano più spesso corrispondenza nei titoli pubblicati dai venditori rispetto alle traduzioni in inglese. Non è un ID articolo né il nome di un venditore. Invialo come keyword all'interno di params.
Quali campi può restituire search di Xianyu?
Il suo schema dichiarato include item_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 Xianyu rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. item_detail runs solo in modo sincrono: legge tutto ciò che restituisce (tutti i target di un batch, o tutti gli SKU di un prodotto) nella stessa chiamata, e una richiesta con "mode": "async" riceve un 422 prima di qualsiasi addebito. 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.