amazon/
seller-info

Convierta URL públicas conocidas de perfiles de vendedores de Amazon en campos normalizados de identidad del vendedor, descripción, sitio web, calificación, comentarios, ubicación, fuente y momento de recopilación.

Amazon Seller Info API

Detalles del perfil del vendedor
Marketplaces compatibles
Un registro por URL
0.15 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioLista 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.

  1. Copie una o más URL públicas de perfiles de vendedores de Amazon de un marketplace compatible.
  2. Envíe por POST la lista urls a /v1/amazon/seller-info y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
  4. 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.items

Casos 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.

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.

Explorar otras plataformas

Combine los datos de Amazon con datos públicos de otras plataformas sociales compatibles.

Amazon Seller Info API — FAQ

Amazon Seller Info API es una interfaz basada en URL para recopilar los campos públicos de perfiles de vendedores de Amazon en un esquema de vendedor normalizado. No accede a los datos privados de cuentas de Seller Central.

La validación del entorno de ejecución acepta los hosts de Amazon de Estados Unidos, Reino Unido, Alemania, Francia, España, Italia, Canadá, Australia, India y Japón, incluidos sus subdominios.

No. Cada URL no vacía enviada se convierte en una entrada de detalle y puede producir como máximo un registro de vendedor almacenado, pero las páginas no disponibles, no válidas para el proveedor o vacías pueden no devolver ningún registro.

No. results_limit no es un campo de solicitud aceptado, y el proveedor recibe una fila de detalle por URL. El endpoint de resultados de la tarea sí puede paginar los elementos almacenados con limit y next_cursor.

Cada registro de vendedor devuelto con éxito cuesta 0.15 créditos de SocQ. La solicitud reserva 0.15 créditos por cada URL enviada y luego liquida según el result_count real. Un resultado vacío exitoso tiene el cargo base de cero créditos y reembolsa la reserva que no se usó.