API di Etsy

Etsy Shop API

Look up one Etsy shop by name and get its id, location, sales, active listings, rating, reviews count, followers, description, logo and banner in one normalized response.

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

Prezzi e provider

Prezzi dell'API Etsy Shop: 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 12,13 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 in una sola richiesta

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `followers`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.
{
  "data": {
    "items": [
      {
        "banner": "example",
        "description": "A short example description of this item.",
        "followers": 12500,
        "image": "https://example.com/image.jpg",
        "listingCount": 12500,
        "location": "example",
        "name": "Example title",
        "ownerId": "Alex Rivera",
        "rating": 4.6,
        "reviewsCount": 12500,
        "salesCount": 12500,
        "shopId": "a1b2c3d4",
        "url": "https://example.com/page"
      }
    ]
  },
  "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.

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `followers`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.

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[]

Shop profile records (one per requested shop name). Populated whenever the provider has data for the entity.

  • bannerstringpuò richiedere

    Shop banner image URL, or null when the shop has none or the serving source does not report it.

  • descriptionstringpuò richiedere

    The shop's headline, or null when the serving source does not report it.

  • followersintegerpuò richiedere

    Number of shoppers following the shop, or null when the serving source does not report it.

  • imagestringpuò richiedere

    Shop logo URL, or null when the serving source does not report it.

  • listingCountinteger

    Number of active listings, or null when not reported. Populated whenever the provider has data for the entity.

  • locationstring

    Where the shop says it is based, e.g. "Shrewsbury, United Kingdom", or null when not shown. Populated whenever the provider has data for the entity.

  • namestring

    Shop name as Etsy shows it. Populated whenever the provider has data for the entity.

  • ownerIdstringpuò richiedere

    Etsy user id of the shop owner, or null when the serving source does not report it.

  • ratingnumber

    Average shop rating, 0-5, or null when unrated. Populated whenever the provider has data for the entity.

  • reviewsCountintegerpuò richiedere

    Number of shop reviews, or null when the serving source does not report it.

  • salesCountinteger

    Lifetime sales the shop shows, or null when hidden. Populated whenever the provider has data for the entity.

  • shopIdstring

    Etsy's numeric shop id. Populated whenever the provider has data for the entity.

  • urlstring

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

top level
  • foundboolean

    True when the shop was found.

  • 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

L'API Etsy Shop di AnyAPI restituisce dati Etsy come JSON normalizzato da una sola chiamata POST a /v1/run/etsy.shop. Look up one Etsy shop by name and get its id, location, sales, active listings, rating, reviews count, followers, description, logo and banner 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.

Look up one Etsy shop by name and get its id, location, sales, active listings, rating, reviews count, followers, description, logo and banner 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 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 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.