Los creadores del Amazon Influencer Program tienen una tienda en amazon.com/shop/<name>. Agrupan productos en listas de ideas y publicaciones seleccionadas, vinculan sus cuentas sociales y destacan productos en tendencia. Para un equipo de afiliados o de influencers, esa página responde preguntas prácticas: quién es el creador, dónde más publica, qué recomienda esta temporada y qué tamaño tiene cada lista.
El 2026-11-17, SocQ añadió la Amazon Storefront API, que devuelve una tienda como un único registro estructurado. Esta guía explica la solicitud, los campos, el precio y cómo integrarla en un flujo de investigación de creadores.
Respuesta rápida: envíe la URL de una tienda en
urlaPOST /v1/amazon/shop. ConsulteGET /v1/tasks/{task_id}hasta que la tarea termine con éxito y lea una fila dedata.results.itemscon el perfil del creador,social_urls,lists,curationsytrending_picks. Cada solicitud cuesta 0.5 créditos ($0.0025).
Qué devuelve el endpoint
1 crédito de SocQ = $0.005.
| Endpoint | Qué devuelve | Precio |
|---|---|---|
| Amazon Storefront API | Una fila por tienda: nombre del creador, descripción, avatar, indicador de top creator, perfiles sociales vinculados, listas de ideas con número de artículos, publicaciones seleccionadas con número de productos y productos en tendencia con precios | 0.5 créditos ($0.0025) por llamada |
La fila cubre la primera página de las listas, publicaciones seleccionadas y productos en tendencia de la tienda. Una tienda que no existe falla con reembolso, así que no se le cobra por URL inválidas.
Autenticación y flujo de tareas asíncronas
Todas las solicitudes a SocQ se autentican con una clave de API, y se usa el mismo encabezado para el envío, el estado de la tarea y la obtención de resultados:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Cada recopilación se ejecuta como una tarea en segundo plano:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La respuesta del envío contiene data.task_id y data.status. Consulte la tarea con ese ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Cuando status es succeeded, la respuesta incluye la primera página de registros normalizados en data.results.items. limit vale 50 por defecto y llega hasta 500; si has_more es true, pase results.next_cursor como cursor. Mientras una tarea está en queued, running o failed, el endpoint devuelve los metadatos de la tarea sin results.
Un callback_url opcional en el cuerpo del envío hace que SocQ envíe un único POST con un resumen de la tarea cuando esta termina; lea los registros con GET /v1/tasks/{task_id}. Un tiempo de espera agotado en el cliente no cancela la tarea, así que reanude con el mismo ID de tarea en lugar de pagar por un duplicado. 402 significa créditos insuficientes; 429 significa que la clave alcanzó un límite de frecuencia o de créditos.
Solicite una tienda
La única entrada es url, una tienda con el formato amazon.com/shop/<name>. Los demás marketplaces de Amazon funcionan del mismo modo.
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"
}'
El endpoint acepta una URL por solicitud. Para leer una lista de tiendas, envíe una tarea por URL, guarde cada task_id con su entrada y consúltelas de forma independiente.
Entienda el registro de la tienda
Un resultado recortado del ejemplo de la documentación tiene este aspecto:
{
"id": "sydneydelrey",
"platform": "amazon",
"resource": "shop",
"type": "storefront",
"url": "https://www.amazon.com/shop/sydneydelrey",
"name": "sydney del rey",
"is_top_creator": true,
"social_urls": [
"https://vm.tiktok.com/ZTFrowSpg/",
"https://www.youtube.com/channel/UCWvW1JOQ-nsAinO1jLFgrVA",
"https://www.pinterest.com/sydneydelrey"
],
"lists": [
{
"title": "Holiday home goods",
"url": "https://www.amazon.com/shop/sydneydelrey/list/XYAIGEFWJGML?tag=sydneybertonc-20",
"items_count": 107
}
],
"curations": [
{
"title": "f/w fit try ons",
"url": "https://www.amazon.com/shop/sydneydelrey/curation/71fad634-5787-4ee1-bc3c-6e3ca23e5eae",
"posts_count": 109
}
],
"trending_picks": [
{
"url": "https://www.amazon.com/shop/sydneydelrey/getProductDetails/B0FCLQD6BN?showRelatedPost=true&tag_override=sydneybertonc-20",
"price": 24.99,
"discount": null
}
]
}
Los campos, agrupados según su uso:
- Identidad del creador:
id(el nombre de la tienda en la URL),name,text(la descripción que escribió el creador),avatar_urleis_top_creator, que indica si Amazon marca al creador como top creator. - Alcance multiplataforma:
social_urls, los perfiles sociales vinculados en la tienda. - Estructura del catálogo:
listscontitle,url,image_urleitems_count;curationscontitle,url,image_urlyposts_count(el número de productos de la publicación seleccionada). - Promociones actuales:
trending_picksconurl,image_url,priceen la moneda del marketplace ydiscountcuando se muestra uno.
Cada fila también incluye collected_at, el momento en que SocQ la recopiló. Los precios cambian, así que guarde esa marca de tiempo con cualquier precio que conserve. La tabla completa de campos está en la documentación de Amazon Storefront.
Cuándo usarla
Buscar socios afiliados. is_top_creator, el número de listas y el items_count de cada una dan una idea rápida de lo activa que está una tienda antes de que alguien de su equipo la abra.
Seguir lo que recomienda un creador. Vuelva a leer una tienda de forma periódica y compare títulos de listas, recuentos y productos en tendencia entre ejecuciones para ver qué impulsa el creador esta temporada.
Conectar una tienda con las cuentas sociales del creador. social_urls le da los perfiles de TikTok, YouTube o Pinterest que vincula el creador. Páselos a las Creator API para encontrar emails profesionales públicos, o a los endpoints de perfil de cada plataforma para obtener el número de seguidores.
Investigación de productos. Los productos en tendencia apuntan a productos concretos. Para obtener datos completos de producto, reseñas o rankings de categoría, use los otros endpoints de Amazon de SocQ, como la Amazon Product Details API y la Amazon Best Sellers API. Para ver cómo se comparan con las API propias de Amazon, consulte alternativas a la Amazon Product Advertising API.
Consejos para producción
- Normalice las URL. Mantenga una forma canónica
amazon.com/shop/<name>por creador para no pagar dos veces por la misma tienda. - Espere una instantánea de la primera página. Las listas, publicaciones seleccionadas y productos en tendencia son los que aparecen en la primera página de la tienda. Trate los recuentos como una instantánea en
collected_at. - Gestione los fallos por separado. Una tienda que no existe falla con reembolso. Márquela como desaparecida en lugar de reintentarla.
- Presupueste de forma sencilla. A 0.5 créditos por tienda, 1,000 tiendas cuestan 500 créditos, es decir, $2.50.
Preguntas frecuentes
¿Qué es la Amazon Storefront API?
Es un endpoint de SocQ que lee la tienda de un creador de Amazon (amazon.com/shop/<name>) y devuelve el perfil del creador, las redes vinculadas, las listas de ideas, las publicaciones seleccionadas y los productos en tendencia como un único registro estructurado.
¿Funciona fuera de amazon.com?
Sí. La documentación indica que los demás marketplaces de Amazon funcionan del mismo modo: envíe en url la URL de la tienda en ese marketplace. Los precios de trending_picks están en la moneda de ese marketplace.
¿Devuelve todos los productos de cada lista?
No. La fila cubre la primera página de la tienda: el título, la URL, la imagen de portada y el items_count de cada lista, el número de productos de cada publicación seleccionada y los productos en tendencia actuales. No despliega cada artículo de las listas.
¿Se me cobra si la tienda no existe?
No. Una tienda que no existe falla con reembolso. Una solicitud correcta cuesta 0.5 créditos ($0.0025).
¿Puedo enviar varias tiendas en una solicitud?
La solicitud acepta un único url. Envíe una tarea por tienda y haga seguimiento de cada task_id.
AMAZON API
Probar el flujo de trabajo con una URL pública de Amazon
Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.
Ver las API de Amazon