Amazon Seller Info
Las páginas de perfil de vendedor de Amazon pueden mostrar el nombre del vendedor, una descripción pública, la calificación, el total de comentarios, el sitio web y el contexto de ubicación. SocQ recopila los campos públicos disponibles de las URL de vendedores conocidas en un esquema de vendedor estable, y los valores privados, ausentes, propios de un marketplace o no disponibles quedan en null en lugar de inferirse.
Funcionalidades de la Amazon Seller Info API
- Recopilación por URL de vendedores conocidosEnvíe una o más URL públicas de perfiles de vendedores de diez marketplaces de Amazon compatibles, entre ellos Estados Unidos, Reino Unido, la Unión Europea, Canadá, Australia, India y Japón.
- Identidad de vendedor estableReciba el ID del vendedor, la URL pública, el nombre del vendedor o del negocio, la descripción, el sitio web asociado y la marca de tiempo de la recopilación en una estructura de resultado fija.
- Señales públicas de reputaciónConserve los valores de rating y feedback_count reportados por la fuente cuando Amazon los expone, sin calcular ni completar las mediciones ausentes.
- Contexto de ubicación del marketplaceAlmacene los campos disponibles de nombre de la ubicación, ciudad, región, país, latitud y longitud, y permita que cualquier valor opcional de ubicación quede en null.
Parámetros de la Amazon Seller Info API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria y no vacía de referencias públicas a vendedores de Amazon. El nombre de host analizado debe pertenecer a un marketplace compatible o a un subdominio; se aceptan referencias con cualquier esquema que tenga un nombre de host y referencias relativas al protocolo. Use rutas de perfil de vendedor para esta operación de detalle. |
Cómo usar la Amazon Seller Info API
Envíe URL públicas de perfiles de vendedores de Amazon, siga la tarea asíncrona y lea los registros de vendedores normalizados en el resultado paginado de la tarea.
- Copie una o más URL públicas de perfiles de vendedores de Amazon de un marketplace compatible.
- Envíe por POST la lista urls a /v1/amazon/seller-info y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
- Lea data.results.items y siga next_cursor solo cuando has_more sea true.
curl -X POST "https://api.socq.ai/v1/amazon/seller-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/sp?seller=A2L77EE7U53NWQ"]}'
# Poll GET /v1/tasks/{task_id}
# Read normalized sellers from data.results.itemsCasos de uso de la Amazon Seller Info API
- Mapeo de la identidad de vendedores: Convierta una lista preparada de URL de perfiles de vendedores en ID, nombres, URL públicas, sitios web y contexto de marketplace consistentes.
- Instantáneas de reputación: Registre la calificación pública, el total de comentarios y el momento de collected_at para comparar en momentos concretos de forma repetible, sin tratar los valores como flujos en vivo.
- Revisión de proveedores del marketplace: Arme una cola de revisión que mantenga la descripción pública del vendedor, el sitio web, la ubicación y las señales de comentarios vinculadas a la URL del perfil de origen.
Consejos de expertos para la Amazon Seller Info API
- Envíe enlaces canónicos de perfiles de vendedor como /sp?seller={seller_id}; las páginas de producto y de búsqueda cumplen la regla del host, pero no son entradas válidas para el detalle de un vendedor.
- No envíe results_limit. El backend crea una entrada de detalle por URL y limita los resultados almacenados a la cantidad de URL no vacías enviadas.
- Una URL aceptada puede devolver cero o un registro de vendedor. Por eso, las páginas ausentes o no disponibles pueden hacer que result_count sea menor que la cantidad de URL.
- Trate rating y feedback_count como instantáneas reportadas por la fuente, y use collected_at al comparar recopilaciones repetidas.
- Los campos de ubicación y el sitio web son opcionales. No infiera presencia legal, titularidad ni verificación a partir de un valor nulo o de un perfil público.
APIs relacionadas
Además de la Amazon Seller Info 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 Storefront API — Lee la tienda de un creador de Amazon a partir de su URL con perfil, cuentas sociales vinculadas, listas de ideas con número de artículos, posts curados y productos en tendencia con precio.