API di Etsy

Etsy Shop listings API

List one Etsy shop's active listings by shop name, a page at a time, and get title, price, original price and image for each listing in one normalized response.

POST/v1/run/etsy.shop_listings
Richieste
-
30d

Prezzi e provider

Prezzi dell'API Etsy Shop listings: una sola API, 2 provider intercambiabili

Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.

Provider
1BadgerServe per primo0,85 USD/1k richiesteflat2ChameleonRiserva 11,07 USD/1k richiesteflat
Paghi
8,50 USD
0,85 USD/1k richieste, solo per ciò che usi. Nessun piano mensile.
Le tue prime 117 richieste sono gratuite con il saldo iniziale di 0,10 USD.

Provalo

Ottieni Etsy Shop listings in una sola richiesta

Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.
{
  "data": {
    "items": [
      {
        "currency": "USD",
        "image": "https://example.com/image.jpg",
        "listingId": "a1b2c3d4",
        "originalPrice": 19.99,
        "price": 19.99,
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ],
    "totalResults": 12500
  },
  "found": true,
  "reason": "not_found"
}

Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.

Riferimento

Una richiesta, una sola forma di risposta.

Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.

Ultima verifica 2026-10-23 · disponibilità e latenza misurate su 30d

Corpo della richiesta

JSON, inviato a questo endpoint.

  • shopNamestring

    StudioStelleHD

    Etsy shop name, as in the shop URL (https://www.etsy.com/shop/<name>), e.g. StudioStelleHD. The Etsy Search and Etsy Product SKUs return it as shopName.

  • pageinteger

    1-based results page of the shop's listings. Each page is billed as one request.

Tu invii. Un piccolo corpo JSON. I valori mostrati sono esempi da sostituire con i tuoi.

Risposta

JSON, un valore di esempio per campo.

each itemdata.items[]

The shop's active listings for the requested page, in the shop's own order. Populated whenever the provider has data for the entity.

  • currencystring

    Price currency code, e.g. "USD", or null when no price is shown. Populated whenever the provider has data for the entity.

  • imagestring

    Primary listing image URL, or null when the listing has none. Populated whenever the provider has data for the entity.

  • listingIdstring

    Etsy listing id, the number in the listing URL (https://www.etsy.com/listing/<id>/...); pass it to the Etsy Product SKU. Populated whenever the provider has data for the entity.

  • originalPricenumber

    Price before the current sale, or null when the listing is not on sale.

  • pricenumber

    Current price in the listing currency, or null when not shown. Populated whenever the provider has data for the entity.

  • titlestring

    Listing title. Populated whenever the provider has data for the entity.

  • urlstring

    Etsy listing page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.

datadata

Listings wrapper, or null when the shop has none.

  • totalResultsinteger

    Total listings the shop has for sale, or null when not reported.

top level
  • foundboolean

    True when the shop has at least one active listing on the requested page.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Tu ricevi. Campi con nome e tipo nella stessa struttura, qualunque fonte risponda.

FAQ

Sull'API Etsy Shop listings

L'API Etsy Shop listings di AnyAPI restituisce dati Etsy come JSON normalizzato da una sola chiamata POST a /v1/run/etsy.shop_listings. List one Etsy shop's active listings by shop name, a page at a time, and get title, price, original price and image for each listing in one normalized response. AnyAPI instrada ogni richiesta su 2 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 0,85 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile.

Costa da 0,85 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Ricarichi un portafoglio in USD e ogni chiamata lo scala. Alcune richieste fallite finanziate dal portafoglio comportano costi di elaborazione che trasferiamo al costo, senza ricarico; la risposta di errore mostra l'importo addebitato.

List one Etsy shop's active listings by shop name, a page at a time, and get title, price, original price and image for each listing in one normalized response. La risposta è JSON normalizzato con la stessa busta che restituisce ogni endpoint AnyAPI, quindi analizzare un secondo endpoint significa cambiare l'URL e nient'altro.

Sì. Un nuovo account AnyAPI parte con 0,10 USD di saldo gratuito e senza bisogno di carta, che copre 117 chiamate Etsy Shop listings a 0,00085 USD ciascuna.

AnyAPI interroga la successiva delle sue 2 fonti nella stessa richiesta, partendo dalla più economica, quindi una fonte che cade non fa fallire la tua chiamata.

Invia una richiesta POST a https://api.getanyapi.com/v1/run/etsy.shop_listings con la tua chiave AnyAPI in un header "Authorization: Bearer" e l'input come corpo JSON. La stessa chiave e lo stesso portafoglio funzionano su ogni endpoint AnyAPI.

No. Aggiungi dollari statunitensi a un unico saldo prepagato AnyAPI e ogni richiesta lo scala. Non c'è un piano mensile né un minimo, e lo stesso saldo paga ogni endpoint AnyAPI.

Sì. Installa @getanyapi/sdk da npm per TypeScript o getanyapi da pip per Python. Entrambi chiamano ogni endpoint AnyAPI con la stessa chiave, e funziona anche qualsiasi client HTTP.

Sì. Un agente può collegarsi al server MCP di AnyAPI su https://api.getanyapi.com/mcp, oppure creare da solo la propria chiave di prova gratuita con un POST non autenticato a https://api.getanyapi.com/agent/signup e chiamare questo endpoint via HTTP.