Amazon Storefront
Un Amazon storefront es la tienda que un miembro del Programa de Influencers de Amazon mantiene con su propio nombre de tienda, donde agrupa productos en listas de ideas y posts curados junto a una descripción, una foto de perfil, enlaces a sus redes y una fila de productos en tendencia. Leerla muestra quién es el creador, dónde más publica, cómo organiza sus recomendaciones y qué productos destaca en este momento y a qué precio.
Funcionalidades de la Amazon Storefront API
- Perfil e insignia de top creatorname, text y avatar_url aportan el nombre visible, la descripción de la tienda y la foto de perfil, e is_top_creator indica si Amazon marca a la persona como top creator.
- Cuentas sociales vinculadassocial_urls reúne los perfiles de TikTok, YouTube, Pinterest y otras redes que el creador enlaza desde la cabecera de la tienda.
- Listas de ideas con número de artículoslists devuelve cada lista de ideas de la primera página de la tienda con su título, enlace, imagen de portada e items_count, la cantidad de productos que contiene.
- Posts curadoscurations devuelve los posts curados del creador con su título, enlace, imagen de portada y posts_count, la cantidad de productos agrupados en cada uno.
- Productos en tendencia con preciotrending_picks devuelve los productos que la tienda destaca ahora, cada uno con su enlace en la tienda, su imagen, el precio actual en la moneda del marketplace y el descuento que se muestre.
Parámetros de la Amazon Storefront API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | La URL de la tienda de un creador de Amazon, con el formato https://www.amazon.com/shop/<name>; las URL de tienda de otros marketplaces de Amazon funcionan igual. |
Cómo usar la Amazon Storefront API
Envíe la URL de una tienda y léala como una única fila de resultado.
- Envíe {"url": "https://www.amazon.com/shop/sydneydelrey"} por POST a /v1/amazon/shop.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea la tienda en results.items; has_more y results.next_cursor siguen las reglas de paginación habituales y quedan vacíos para esta fila única.
curl -X POST "https://api.socq.ai/v1/amazon/shop" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.amazon.com/shop/sydneydelrey"}'Casos de uso de la Amazon Storefront API
- Encontrar creadores afiliados: Comparar is_top_creator, la cantidad de listas de ideas y su items_count entre varias tiendas para quedarse con los creadores que seleccionan productos de su categoría con constancia.
- Seguir lo que recomienda un creador: Leer una tienda cada semana y comparar títulos de listas, items_count y trending_picks para ver qué listas de temporada crecen y qué productos pasan al frente.
- Unir la tienda con las redes sociales: Usar social_urls para vincular cada tienda con los perfiles de TikTok, YouTube o Pinterest del creador y reunir la actividad comercial y el alcance social en un mismo registro.
Consejos de expertos para la Amazon Storefront API
- Guarde el dominio del marketplace con cada resultado, porque trending_picks.price está en la moneda de ese marketplace.
- Use id, el nombre de la tienda tomado de la URL, como clave para que las lecturas repetidas del mismo creador coincidan.
- Si necesita los productos uno por uno, abra la lista o el post curado desde su url; items_count y posts_count le indican antes su tamaño.
APIs relacionadas
Además de la Amazon Storefront API, use estas APIs cuando necesite otro tipo de datos públicos de Amazon.
- Amazon Best Sellers API — Recolecta productos desde URLs públicas de categorías de más vendidos de Amazon, con campos normalizados de vendedor, precio, reputación, cantidad vendida, contenido multimedia, origen y marca de tiempo.
- Amazon Product Details API — Recolecta detalles de productos desde URLs conocidas de Amazon, con campos de título, descripción, vendedor, precio, calificación, cantidad de reseñas, cantidad vendida y contenido multimedia.
- Amazon Product Search API — Busca en una tienda de Amazon compatible por frase de producto y devuelve, cuando están disponibles, campos normalizados de producto, vendedor, precio, calificación, reseñas, cantidad vendida, contenido multimedia y fuente.
- Amazon Reviews API — Recolecta reseñas públicas de productos desde URLs de Amazon compatibles, con texto, calificaciones, datos del autor, referencias al producto, marcas de tiempo y contenido multimedia.
- Amazon Seller Info API — Recolecta desde URLs conocidas de vendedores la identidad pública del perfil de vendedor de Amazon, descripción, sitio web, calificación, comentarios, ubicación, origen y campos de hora de recolección.