API 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
Requêtes
-
30d

Tarifs et fournisseurs

Tarifs de l’API Etsy Shop listings : une API, 2 fournisseurs interchangeables

Le fournisseur le moins cher répond en premier. S’il échoue, le suivant prend le relais dans le même appel.

Fournisseur
1BadgerRépond en premier0,85 $US/1k reqflat2ChameleonSecours 11,07 $US/1k reqflat
Vous payez
8,50 $US
0,85 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 117 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez Etsy Shop listings en une requête

Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse
Les exécutions gratuites ne renvoient que les 3 premiers résultats. Alimentez une clé pour obtenir la réponse complète.
{
  "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"
}

Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.

Référence

Une requête, une seule forme de réponse.

Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.

Dernière vérification : 2026-10-23 · disponibilité et latence mesurées sur 30d

Corps de la requête

JSON, envoyé à cet 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.

Vous envoyez. Un petit corps JSON. Les valeurs affichées sont des exemples à remplacer par les vôtres.

Réponse

JSON, une valeur d’exemple par champ.

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.

Vous recevez. Des champs nommés et typés, dans la même forme quelle que soit la source qui répond.

FAQ

À propos de l’API Etsy Shop listings

L’API Etsy Shop listings d’AnyAPI renvoie des données Etsy en JSON normalisé à partir d’un appel POST à /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 route chaque requête sur 2 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 0,85 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel.

Elle coûte à partir de 0,85 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Vous alimentez un portefeuille en USD et chaque appel le débite. Certaines requêtes échouées financées par le portefeuille entraînent des frais de traitement que nous répercutons au prix coûtant, sans marge ; la réponse d’erreur indique le montant facturé.

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 réponse est du JSON normalisé avec la même enveloppe que celle de tous les endpoints AnyAPI, donc analyser un second endpoint revient à changer l’URL et rien d’autre.

Oui. Un nouveau compte AnyAPI démarre avec 0,10 $US de solde gratuit, sans carte, ce qui couvre 117 appels Etsy Shop listings à 0,00085 $US chacun.

AnyAPI interroge la suivante de ses 2 sources dans la même requête, la moins chère d’abord, donc la panne d’une source ne fait pas échouer votre appel.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/etsy.shop_listings avec votre clé AnyAPI dans un en-tête « Authorization: Bearer » et l’entrée en corps JSON. La même clé et le même portefeuille fonctionnent sur tous les endpoints AnyAPI.

Non. Vous ajoutez des dollars US à un solde AnyAPI prépayé unique et chaque requête le débite. Il n’y a ni forfait mensuel ni minimum, et le même solde paie tous les endpoints AnyAPI.

Oui. Installez @getanyapi/sdk depuis npm pour TypeScript ou getanyapi depuis pip pour Python. Les deux appellent chaque endpoint AnyAPI avec la même clé, et n’importe quel client HTTP fonctionne aussi.

Oui. Un agent peut se connecter au serveur MCP d’AnyAPI à https://api.getanyapi.com/mcp, ou créer sa propre clé d’essai gratuit avec un seul POST non authentifié vers https://api.getanyapi.com/agent/signup et appeler cet endpoint en HTTP.