API di Etsy
Cerca schede prodotto e profili dei negozi su Etsy per esaminare materiali, prezzi e riepiloghi delle recensioni dei clienti.
Tieni separati i dettagli delle schede prodotto dalle recensioni a livello di negozio. Prezzi e disponibilità osservati possono cambiare.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su etsy e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 5 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Etsy: 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: $1.39 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Cerca schede Etsy tramite keyword. | Normale | |
Dettagli del prodottoprofile | Recupera il record completo di un prodotto Etsy dall'url della sua scheda: descrizione, materiali, fascia di prezzo, varianti, recensioni in evidenza e il negozio che lo vende. | Normale | |
Recensionireviews | Leggi le recensioni a livello di negozio di uno store Etsy. | Normale | |
Negozioshop | Cerca un negozio Etsy per nome o URL in shop e ottieni ID, località, data di apertura, numero di schede attive e badge Star Seller. | Normale | |
Dettagli del prodottoproduct_detail | Ottieni un prodotto Etsy dall'url della sua scheda. | Normale |
Cosa accetta ogni azione di API di Etsy?
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: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Cerca schede Etsy tramite | keyword | currency, exclude_keywords, min_price, sort | 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. | listing_id · title · url · price · list_price · currency · rating · rating_scale · shop_id · shop_name · shop_rating · shop_review_count · on_sale · free_shipping · is_digital · image_url · platform | |
profileDettagli del prodotto Recupera il record completo di un prodotto Etsy dall' | url | — | — | listing_id · title · url · description · materials · category · price · price_min · price_max · currency · review_count · shop_id · shop_name · shop_review_count · shop_years · ships_from_country · image_url · platform · images · review_highlights · review_tags · variants | |
reviewsRecensioni Leggi le recensioni a livello di negozio di uno store Etsy. Passa il suo nome breve o l'URL del negozio in | shop | — | 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. | review_id · text · rating · rating_scale · author_name · author_username · posted_at · listing_title · seller_response · product_url · shop_name · shop_url · shop_rating · shop_review_count · platform | |
shopNegozio Cerca un negozio Etsy per nome o URL in | shop | shop_name, username | — | shop_id · shop_name · shop_url · is_star_seller · active_listing_count · on_etsy_since · location · platform | |
product_detailDettagli del prodotto Ottieni un prodotto Etsy dall' | url | — | — | id · url · name · text · price · original_price · currency · in_stock_quantity · rating · rating_scale · review_count · shop_id · variants · tags · image_url · platform |
Cosa significano i parametri search di API di Etsy?
Cerca schede Etsy tramite keyword. Ottieni prezzo, prezzo di listino, valuta, valutazione e il negozio dietro ogni articolo. I filtri facoltativi riguardano valuta, esclusioni dal titolo, prezzo minimo e ordinamento. I dati delle schede non garantiscono produzione artigianale, disponibilità o consegna.
keywordObbligatorio- Specifica la stringa di ricerca dei prodotti Etsy (ad esempio ceramic mug) per interrogare titoli degli articoli e inserzioni. Non è una ricerca esatta di negozi; per recuperare profili o recensioni dei negozi usa shop.
currencyFacoltativo- Imposta la valuta dei prezzi delle inserzioni nei risultati di ricerca con uno dei codici valuta minuscoli supportati, con usd come predefinito. Il parametro min_price viene interpretato in questa valuta. L'impostazione influisce solo sui valori mostrati nella risposta e non cambia la valuta di addebito delle API della piattaforma.Valori ammessi:
audbrlcadchfdkkeurgbphkdinrjpymxnnoknzdseksgdusd exclude_keywordsFacoltativo- Esclude gli articoli il cui titolo contiene una qualsiasi delle stringhe di questo array (ad esempio ["digital", "download"]). Il confronto non distingue tra maiuscole e minuscole. Il filtro controlla solo i titoli degli articoli: non esclude venditori specifici né garantisce l'analisi delle descrizioni complete.
min_priceFacoltativo- Filtra i risultati di ricerca dei prodotti Etsy per prezzo minimo dell'inserzione con un numero non negativo nella valuta specificata. Non rappresenta quantità minime d'ordine, costi massimi di spedizione o limiti di budget per le richieste.
sortFacoltativo- Controlla l'ordine dei risultati di ricerca dei prodotti per l'azione search di Etsy. I valori supportati sono relevance (predefinito), price_asc, price_desc e newest. Sono supportati anche gli alias legacy di compatibilità most_relevant, lowest_price, highest_price e recently_listed. Questo parametro non ordina le recensioni dei negozi.Valori ammessi:
newestprice_ascprice_descrelevance
Cosa significano i parametri profile di API di Etsy?
Recupera il record completo di un prodotto Etsy dall'url della sua scheda: descrizione, materiali, fascia di prezzo, varianti, recensioni in evidenza e il negozio che lo vende. Nonostante il nome dell'azione, profile riguarda un prodotto, non un account acquirente né la pagina completa del negozio.
urlObbligatorio- Accetta l'URL completo di un'inserzione Etsy nel formato /listing/<ID>/ per le azioni profile e product_detail, per recuperare i dettagli di un singolo articolo. Nota che profile riguarda i dettagli dell'articolo, non i profili utente. Non può sostituire il parametro obbligatorio shop nelle query agli endpoint dei negozi.
Cosa significano i parametri reviews di API di Etsy?
Leggi le recensioni a livello di negozio di uno store Etsy. Passa il suo nome breve o l'URL del negozio in shop. Ottieni valutazione, autore, titolo della scheda correlata ed eventuale risposta del venditore. Riguardano il negozio nel suo complesso, non una singola scheda. Il batch non copre tutte le vendite.
shopObbligatorio- Identifica il negozio tramite il nome breve o un URL completo come https://www.etsy.com/shop/<shop_name>. Per l'azione reviews restituisce le recensioni a livello di negozio, non quelle delle singole inserzioni; per l'azione shop recupera i metadati generali del negozio.Etsy: i formati dei link ai negozi — La documentazione ufficiale di Etsy indica che i link ai negozi contengono il nome breve del negozio, ad esempio www.etsy.com/shop/shopname. Usa il nome breve del negozio o un link /shop/ come richiesto da questo parametro e non sostituire i link ai negozi con link alle schede prodotto. · Verificato
Cosa significano i parametri shop di API di Etsy?
Cerca un negozio Etsy per nome o URL in shop e ottieni ID, località, data di apertura, numero di schede attive e badge Star Seller. is_star_seller riflette il badge come rilevato, non una promessa sulla qualità futura del servizio.
shopObbligatorio- Identifica il negozio tramite il nome breve o un URL completo come https://www.etsy.com/shop/<shop_name>. Per l'azione reviews restituisce le recensioni a livello di negozio, non quelle delle singole inserzioni; per l'azione shop recupera i metadati generali del negozio.Etsy: i formati dei link ai negozi — La documentazione ufficiale di Etsy indica che i link ai negozi contengono il nome breve del negozio, ad esempio www.etsy.com/shop/shopname. Usa il nome breve del negozio o un link /shop/ come richiesto da questo parametro e non sostituire i link ai negozi con link alle schede prodotto. · Verificato
shop_nameFacoltativo- Input di compatibilità che rappresenta il nome breve del negozio Etsy. Le chiamate alle azioni reviews o shop devono comunque includere il parametro principale obbligatorio shop.
usernameFacoltativo- Input di compatibilità di riserva per il nome breve del negozio, con precedenza inferiore a shop e shop_name. Non rappresenta lo username di un acquirente e il parametro obbligatorio shop va comunque fornito.
Cosa significano i parametri product_detail di API di Etsy?
Ottieni un prodotto Etsy dall'url della sua scheda. Include descrizione, prezzo attuale e originale, quantità disponibile visibile, valutazione, varianti e tag. in_stock_quantity è il numero mostrato nella pagina, non un inventario verificato. Non viene riservato nulla.
urlObbligatorio- Accetta l'URL completo di un'inserzione Etsy nel formato /listing/<ID>/ per le azioni profile e product_detail, per recuperare i dettagli di un singolo articolo. Nota che profile riguarda i dettagli dell'articolo, non i profili utente. Non può sostituire il parametro obbligatorio shop nelle query agli endpoint dei negozi.
Come usare l'API di Etsy
- 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":"etsy","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Etsy
Cosa posso ottenere con l'API di Etsy?
Imposta platform su etsy. Il catalogo attuale elenca ricerca, dettagli del prodotto, recensioni, negozio e dettagli del prodotto. Questi nomi di azione identificano oggetti o viste diversi di Etsy; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Etsy?
Specifica la stringa di ricerca dei prodotti Etsy (ad esempio ceramic mug) per interrogare titoli degli articoli e inserzioni. Non è una ricerca esatta di negozi; per recuperare profili o recensioni dei negozi usa shop. Invialo come keyword all'interno di params.
Quali campi può restituire search di Etsy?
Il suo schema dichiarato include listing_id, title, price e list_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 Etsy 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.