API de Etsy

API de 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.

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

Precios y proveedores

Precios del endpoint Shop de la API de Etsy: una API, 2 proveedores intercambiables

El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.

Proveedor
1BadgerResponde primeroUS$0.85/1k solic.flat2ChameleonRespaldo 1US$2.13/1k solic.flat
Pagas
US$8.50
US$0.85/1k solic., solo por lo que usas. Sin plan mensual.
Tus primeras 117 solicitudes son gratis con el saldo inicial de US$0.10.

Pruébalo

Obtén Shop de Etsy en una sola solicitud

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.
Abrir en
Respuesta de ejemplo
Las ejecuciones gratis devuelven solo los primeros 3 resultados. Agrega fondos a una clave para obtener la respuesta 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"
}

Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.

Referencia

Una solicitud, un formato de respuesta.

Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.

Verificado por última vez el 2026-10-23 · disponibilidad y latencia medidas en 30d

Cuerpo de la solicitud

JSON, enviado por POST a este 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.

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo por campo.

each itemdata.items[]

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

  • bannerstringse puede exigir

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

  • descriptionstringse puede exigir

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

  • followersintegerse puede exigir

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

  • imagestringse puede exigir

    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.

  • ownerIdstringse puede exigir

    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.

  • reviewsCountintegerse puede exigir

    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.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

Preguntas frecuentes

Acerca del endpoint Shop de la API de Etsy

El endpoint Shop de AnyAPI para Etsy devuelve datos de Etsy como JSON normalizado con una sola llamada 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 enruta cada solicitud entre 2 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$0.85 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual.

Cuesta desde US$0.85 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto cobrado.

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 respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta, que alcanza para 117 llamadas a Shop de Etsy a US$0.00085 cada una.

AnyAPI consulta la siguiente de sus 2 fuentes en la misma solicitud, empezando por la más barata, así que la caída de una fuente no hace fallar tu llamada.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/etsy.shop con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.