EveryInfra
Buscar⌘K
Español
EntrarEmpieza gratis

API de Búsqueda de Etsy

POST

Salud de la API

Salud 24 h
Normal
Tiempo medio 24 h
—
Última comprobación
26 de septiembre de 2026 a las 18:04 (UTC)
  • Saludable / normal
  • Disponible
  • Limitada
  • Casi sin servicio
API de saludNormal
Cómo se mide la salud
  • Salud = porcentaje de llamadas que devolvieron datos. Los resultados vacíos, los fallos y los resultados desconocidos no cuentan como datos devueltos.
  • Niveles: desde 90 % saludable, desde 70 % disponible, desde 40 % limitada; por debajo, casi sin servicio.
  • Un periodo (las últimas 24 horas, una hora o un día) solo se puntúa a partir de 50 llamadas. Los periodos con menos llamadas se muestran como normales: unos pocos fallos entre pocas llamadas no significan que la API esté caída.
  • Las llamadas incluyen las reales de clientes y nuestras llamadas de sondeo diarias. Los errores de la propia solicitud (parámetros incorrectos, saldo insuficiente) no se cuentan.
  • El tiempo medio solo cuenta las llamadas que terminaron con normalidad: tiempo de respuesta en las síncronas; de la aceptación a la finalización en las asíncronas.
Por periodo
Hora (UTC)EstadoSaludTiempo medio
2026-09-26 18:00 - 18:59Normal——
2026-09-26 17:00 - 17:59Normal——
2026-09-26 16:00 - 16:59Normal——
2026-09-26 15:00 - 15:59Normal——
2026-09-26 14:00 - 14:59Normal——
2026-09-26 13:00 - 13:59Normal——
2026-09-26 12:00 - 12:59Normal——
2026-09-26 11:00 - 11:59Normal——
2026-09-26 10:00 - 10:59Normal——
2026-09-26 09:00 - 09:59Normal——
2026-09-26 08:00 - 08:59Normal——
2026-09-26 07:00 - 07:59Normal——
2026-09-26 06:00 - 06:59Normal——
2026-09-26 05:00 - 05:59Normal——
2026-09-26 04:00 - 04:59Normal——
2026-09-26 03:00 - 03:59Normal——
2026-09-26 02:00 - 02:59Normal——
2026-09-26 01:00 - 01:59Normal——
2026-09-26 00:00 - 00:59Normal——
2026-09-25 23:00 - 23:59Normal——
2026-09-25 22:00 - 22:59Normal——
2026-09-25 21:00 - 21:59Normal——
2026-09-25 20:00 - 20:59Normal——
2026-09-25 19:00 - 19:59Normal——
2026-09-26Normal——
2026-09-25Normal——
2026-09-24Normal——
2026-09-23Normal——
2026-09-22Normal——
2026-09-21Normal——
2026-09-20Normal——
2026-09-19Normal——
2026-09-18Normal——
2026-09-17Normal——
2026-09-16Normal——
2026-09-15Normal——
2026-09-14Normal——
2026-09-13Normal——
2026-09-12Normal——
2026-09-11Normal——
2026-09-10Normal——
2026-09-09Normal——
2026-09-08Normal——
2026-09-07Normal——
2026-09-06Normal——
2026-09-05Normal——
2026-09-04Normal——
2026-09-03Normal——
2026-09-02Normal——
2026-09-01Normal——
2026-08-31Normal——
2026-08-30Normal——
2026-08-29Normal——
2026-08-28Normal——

Busca listings de Etsy mediante keyword, con categoría, moneda, exclusiones, precio y orden opcionales. Devuelve tienda, valoración y precio publicado; no garantiza fabricación artesanal, stock o entrega.

Precio $1.39 por 1.000 solicitudes ($0.001389 por llamada). Las llamadas fallidas y los resultados vacíos no se cobran. Síncrona. Para tareas lentas añade "mode": "async" al cuerpo, recibe un job_id y consúltalo.

Parámetros de la solicitud

NombreUbicaciónTipoObligatorioPor defectoDescripción
AuthorizationheaderstringSí-Bearer seguido de tu clave de API. Créala en la consola; nunca la pongas en una URL ni en un repositorio de código.
platformbodystringSíetsyIdentificador de la plataforma, valor fijo.
actionbodystringSísearchIdentificador de la capacidad, valor fijo.
keywordbody.paramsNo declaradoSí-Término de búsqueda para productos de Etsy, como ceramic mug. Se usa para buscar en títulos y anuncios de productos, no es una búsqueda exacta del nombre de la tienda. Para obtener los datos o las reseñas de una tienda, usa shop.
categorybody.paramsenumNo-Categoría del producto: any (cualquiera), jewelry-and-accessories, clothing-and-shoes, home-and-living, wedding-and-party, toys-and-entertainment, art-and-collectibles, craft-supplies-and-tools, vintage, gifts, electronics-and-accessories, bags-and-purses o bath-and-beauty.Valores permitidosanyart-and-collectiblesbags-and-pursesbath-and-beautyclothing-and-shoescraft-supplies-and-toolselectronics-and-accessoriesgiftshome-and-livingjewelry-and-accessoriestoys-and-entertainmentvintagewedding-and-party
currencybody.paramsenumNo-Moneda del precio del producto en los resultados de búsqueda. El valor por defecto es USD. Admite los códigos de moneda listados en esta API. min_price se interpreta según esta moneda y no cambia la moneda de facturación de la llamada a esta API.Valores permitidosaudbrlcadchfdkkeurgbphkdinrjpymxnnoknzdseksgdusd
exclude_keywordsbody.paramsNo declaradoNo-Palabras clave a excluir del título del producto. Envía un array de cadenas, como ["digital", "download"]. Se excluyen los productos cuyo título contenga alguna de las palabras, sin distinguir mayúsculas y minúsculas. No garantiza que se excluyan vendedores ni que se analice la descripción completa del producto.
min_pricebody.paramsNo declaradoNo-Precio mínimo para la búsqueda de productos. Es un valor numérico no negativo en la moneda seleccionada en currency. No es la cantidad mínima de pedido, el límite del coste de envío ni el presupuesto de la llamada a esta API.
sortbody.paramsenumNo-Orden de los resultados de búsqueda de productos: relevance (relevancia, por defecto), price_asc (precio ascendente), price_desc (precio descendente) o newest (más recientes). Compatible con los valores antiguos most_relevant, lowest_price, highest_price y recently_listed. No ordena las reseñas de la tienda por fecha.Valores permitidosnewestprice_ascprice_descrelevance
limitbody.paramsinteger (1–50)No20

Ejemplos de código

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "etsy",
  "action": "search",
  "params": {
    "keyword": "ceramic mug"
  }
}'

[Definición OpenAPI (JSON)]Los ejemplos leen la clave de la variable de entorno EVERYINFRA_API_KEY; el código copiado nunca contiene tu clave.

Ejemplo de respuesta

Respuesta real

Obtenida el 26 de septiembre de 2026 a las 08:56 (UTC) llamando a esta API con los parámetros del ejemplo de código de arriba. results y count son la respuesta real de esa llamada, sin información personal (nombres, usuarios, avatares, enlaces de perfil, datos de contacto); la lista conserva los primeros 2. id, billing y quota cambian en cada llamada, por eso solo se muestra su estructura.

json
{
  "id": "req_…",
  "platform": "etsy",
  "action": "search",
  "results": [
    {
      "listing_id": "（已隐去）",
      "title": "The Libby Travel Mug hand thrown ceramic mug cup Pottery Travel Mug Cup with attached lid fits in cup holder",
      "url": "https://www.etsy.com/listing/1510223855/the-libby-travel-mug-hand-thrown-ceramic",
      "price": "34.99",
      "currency": "USD",
      "rating": 5,
      "shop_id": "8740835",
      "shop_name": "StonehousePotteryOH",
      "on_sale": false,
      "free_shipping": false,
      "is_digital": false,
      "image_url": "https://i.etsystatic.com/8740835/r/il/d4f720/7239142492/il_fullxfull.7239142492_oym6.jpg",
      "platform": "etsy",
      "rating_scale": 5
    },
    {
      "listing_id": "（已隐去）",
      "title": "Personalized Engraved Mug – Custom Photo, Text or Logo Ceramic Coffee Cup, 12.8 oz",
      "url": "https://www.etsy.com/listing/4515619135/personalized-engraved-mug-custom-photo",
      "price": "11.14",
      "list_price": "14.85",
      "currency": "USD",
      "rating": 5,
      "shop_id": "65820773",
      "shop_name": "PCraftHandle",
      "on_sale": true,
      "free_shipping": false,
      "is_digital": false,
      "image_url": "https://i.etsystatic.com/65820773/r/il/c96314/8092105956/il_fullxfull.8092105956_4yao.jpg",
      "platform": "etsy",
      "rating_scale": 5
    }
  ],
  "count": 20,
  "billing": { … },
  "quota": { … }
}

Campos de la respuesta

Los datos están en results. La tabla lista los campos que puede tener cada registro; los valores que la fuente no ofrece nunca se inventan.

CampoSignificado
listing_idConserva el significado de la plataforma
titleTítulo. null cuando la plataforma no usa títulos (por ejemplo publicaciones solo de texto).
urlEnlace al registro en la plataforma de origen.
pricePrecio como número, sin símbolo de moneda; ver currency.
list_priceConserva el significado de la plataforma
currencyCódigo de moneda del precio (por ejemplo CNY, USD). Si hay price pero currency es null, no supongas una moneda.
ratingValoración. La escala depende de la plataforma: rating_scale en la misma fila indica el máximo (normalmente 5; Booking, Douban, iQIYI y NAVER usan 10). Convierte con rating_scale antes de comparar entre plataformas o la comparación puede salir al revés.
rating_scaleMáximo de rating en la misma fila: 5 en escalas de cinco estrellas y 10 en escalas de diez puntos. Solo aparece si la fila tiene rating.
shop_idConserva el significado de la plataforma
shop_nameConserva el significado de la plataforma
shop_ratingConserva el significado de la plataforma
shop_review_countConserva el significado de la plataforma
on_saleConserva el significado de la plataforma
free_shippingConserva el significado de la plataforma
is_digitalConserva el significado de la plataforma
image_urlEnlace de imagen. Las capacidades con varias imágenes pueden devolver una lista image_urls.
platformIdentificador de la plataforma de origen, igual que platform en la solicitud (por ejemplo xiaohongshu, tiktok).

Errores y facturación

401
Falta la clave o no es válida. La autenticación se comprueba antes que los parámetros, así que las solicitudes sin autenticar no ven el esquema de parámetros.
422
Nombre o valor de parámetro incorrecto. El error enumera los parámetros y valores permitidos de esta capacidad y la opción más cercana; ocurre antes de cualquier cobro.
402
Saldo insuficiente. Recarga primero.
429
Se alcanzó el límite de solicitudes por minuto. Espera lo que indique Retry-After y vuelve a intentarlo.
503
No se pudo completar ahora. Cualquier cargo de la llamada vuelve automáticamente a tu saldo, y el recibo de facturación de la respuesta indica el resultado real, también cuando aún no se conoce. No reenvíes a ciegas.
200 vacío
La solicitud terminó sin datos y no se cobra (billing.reason = empty_result_refunded).