1. Inicio
  2. Docs
  3. Documentación de Amzpecty
  4. Especificaciones de la API de Amzpecty
  5. API de información del vendedor

API de información del vendedor

AÑADIR ID DEL VENDEDOR A LA COLA DE CONSULTA DE INFORMACIÓN DEL VENDEDOR

La solicitud para agregar un ID de vendedor a la cola de consultas de Información del vendedor.

DEDUCCIÓN DE CRÉDITO

1 (una) deducción de crédito después de la recuperación exitosa de los datos.

SOLICITAR
URI /api/query/seller/{ID DE VENDEDOR}? dominio={dominio}&clavesecreta={clavesecreta} {SELLER ID} – obligatorio – el ID de vendedor del vendedor objetivo {dominio} – opcional – el valor predeterminado es www.amazon.com si no se especifica. Ver Dominios de Amazon compatibles para la lista.
Encabezado HTTP (opcional) AMZPECTY_CALLBACK_URL={Su URL de devolución de llamada}
Ejemplo /api/query/seller/A3A5YZ4E94TE9K?secretKey=XXXXXXXXXX
RESPUESTA
Cabezales
Tipo de medios aplicación / json
Datos JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerinfo",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03be54",
    "dateProcessed": null,
    "domain": null
}
INFORMACIÓN DEL VENDEDOR CONSULTA DEVOLUCIÓN DE LLAMADA DATOS DE MUESTRA JSON
Cabezales
Tipo de medios aplicación / json
Datos JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerinfo",
    "allowed": 4986,
    "dailyAllowed": 4986,
    "messageId": null,
    "message": null,
    "data": {
            "sellerId": "A3VHYG59GNVJVO",
            "sellerName": "CMDStore",
            "logoUrl": "https://images-na.ssl-images-amazon.com/images/I/419Udl8VRCL.png",
            "businessInfo": {
                "Business Name": "9103-6152 Quebec Inc",
                "Business Address": " 3940 Griffith St Montreal QC H4T1A7 CA",
                "other key": "other value"
            },
            "about": "CMDStore is committed to providing each customer with the highest standard of customer service.",
            "feedbackStar": 4.5,
            "productCount": 2000,
            "feedbackPositive30days": 91,
            "feedbackPositive90days": 95,
            "feedbackPositive12months": 96,
            "feedbackPositiveLifetime": 98,
            "feedbackNeutral30days": 4,
            "feedbackNeutral90days": 1,
            "feedbackNeutral12months": 1,
            "feedbackNeutralLifetime": 1,
            "feedbackNegative30days": 4,
            "feedbackNegative90days": 4,
            "feedbackNegative12months": 3,
            "feedbackNegativeLifetime": 1,
            "feedbackCount30days": 23,
            "feedbackCount90days": 75,
            "feedbackCount12months": 357,
            "feedbackCountLifetime": 13300
            },
   "rid": "60f12c1a0cf24280ed03be5e",
   "dateProcessed": 1626418203388,
   "domain": "www.amazon.com",
   "totalCreditsDeducted": 1
}
INFORMACIÓN DEL VENDEDOR CONSULTA RESPUESTA DE LLAMADA ATRIBUTOS JSON
Nombre del AtributoDetalles
estadoEl estado de la solicitud.
respuesta paraValor de “sellerinfo” para el resultado de la consulta de información del vendedor.
permitidoEl recuento de solicitudes permitidas actualmente. Se reinicia mensualmente.
diarioPermitidoEl recuento de solicitudes diarias permitidas actualmente. Se reinicia diariamente.
mensajeIdLa identificación del mensaje (si corresponde).
mensajeEl mensaje real (si lo hay). Consulte Mensajes de error.
librarLa identificación de la solicitud. Esto se puede utilizar en la consulta Obtener como clave.
dominioEl dominio de Amazon correspondiente al Vendedor.
totalCréditosDeducidosEste campo indica cuántos créditos API de Amzpecty se utilizaron para cumplir con esta solicitud.
fechaProcesadoLa fecha en que se procesó la solicitud en formato de hora Unix.
datos.sellerIdLa identificación del vendedor.
datos.nombredelvendedorEl nombre en línea del vendedor.
data.logoUrlLa URL del logotipo del vendedor.
datos.negocioInfoMapa de pares de valores clave, por ejemplo
Nombre comercial = 9103-6152 Quebec Inc.
Dirección comercial = 558A Hempstead Ave WEST TOWN Nueva York 112233 EE. UU.
(otra_clave = otro_valor)
datos.sobreSobre el vendedor.
datos.feedbackStarLista de pares de valores clave de marcas de productos que ofrece el vendedor.
datos.productCountEl número de productos del vendedor.
** DESPRECADO 2/16/2024 **
datos.productBrands[]
Lista de pares de valores clave de marcas de productos que ofrece el vendedor.
datos.feedbackPositivo30díasEl vendedor recibió comentarios positivos durante un período de 30 días.
datos.feedbackPositivo90díasEl vendedor recibió comentarios positivos durante un período de 90 días.
data.feedbackPositivo12mesesEl vendedor recibió comentarios positivos durante un período de 12 meses.
datos.feedbackPositiveLifetimeComentarios positivos del vendedor durante toda la vida.
datos.feedbackNeutral30díasEl vendedor ofrece comentarios neutrales durante un período de 30 días.
datos.feedbackNeutral90díasEl vendedor ofrece comentarios neutrales durante un período de 90 días.
data.feedbackNeutral12mesesComentarios neutrales del vendedor durante un período de 12 meses.
datos.feedbackNeutralLifetimeComentarios neutrales del vendedor durante toda la vida.
datos.feedbackNegativo30díasComentarios negativos del vendedor durante un período de 30 días.
datos.feedbackNegativo90díasComentarios negativos del vendedor durante un período de 90 días.
datos.feedbackNegativo12mesesComentarios negativos del vendedor durante un período de 12 meses.
datos.feedbackNegativeLifetimeComentarios negativos del vendedor durante toda la vida.
datos.feedbackCount30daysLos comentarios del vendedor cuentan durante un período de 30 días.
datos.feedbackCount90daysLos comentarios del vendedor cuentan durante un período de 90 días.
datos.feedbackCount12mesesLos comentarios del vendedor cuentan durante un período de 12 meses.
datos.feedbackCountLifetimeLos comentarios del vendedor cuentan durante el período de por vida.

OBTENER RESULTADO DE INFORMACIÓN DEL VENDEDOR MEDIANTE ID DE SOLICITUD

La solicitud para obtener el resultado de la información del vendedor mediante el ID de solicitud (eliminar).

DEDUCCIÓN DE CRÉDITO

0 (cero) deducción de crédito por la llamada Get.

SOLICITAR
URI /api/query/getsellerinfo/rid/{rid}?secretKey={secretKey} {rid} – ID de solicitud de la respuesta /api/query/estprofit/
Ejemplo /api/query/ getsellerinfo/rid/60f12c1a0cf24280ed03c11d?secretKey=XXXXXXXXXX
RESPUESTA

See Información del vendedor Consulta de devolución de llamada Datos de muestra JSON

AÑADIR ID DEL VENDEDOR PARA OBTENER LA COLA DE CONSULTAS DE ASINS DEL VENDEDOR

La solicitud para agregar un ID de vendedor a la cola de consultas Obtener Asins del vendedor.

advertencia: La API de Amzpecty solo puede obtener un máximo de 2,400 Asins.

DEDUCCIÓN DE CRÉDITO

1 (una) deducción de crédito después de la recuperación exitosa de 1 página de datos Asin. Cada página contiene un máximo de 16 ASINs.

SOLICITAR
URI /api/query/seller/getasins/{ID DE VENDEDOR}? dominio={dominio}&clavesecreta={clavesecreta} {SELLER ID} – obligatorio – el ID de vendedor del vendedor objetivo {dominio} – opcional – el valor predeterminado es www.amazon.com si no se especifica. Ver Dominios de Amazon compatibles para la lista.
Encabezado HTTP (opcional) AMZPECTY_CALLBACK_URL={Su URL de devolución de llamada}
Ejemplo /api/query/seller/getasins/A3A5YZ4E94TE9K?secretKey=XXXXXXXXXX
RESPUESTA
Cabezales
Tipo de medios aplicación / json
Datos JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerasins",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03b000",
    "dateProcessed": null,
    "domain": null
}
OBTENER ASINS DEL VENDEDOR CONSULTAR DEVOLUCIÓN DE LLAMADA DATOS DE MUESTRA JSON
Cabezales
Tipo de medios aplicación / json
Datos JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerasins",
    "allowed": 4986,
    "dailyAllowed": 4986,
    "messageId": null,
    "message": null,
    "data": {
        "sellerId": "A3VHYG59GNVJVO",
        "status": "completed",
        "completedAsins": 2,
        "totalAsins": 2,
        "asins": [
            {
                "asin": "B07JLCLVRJ",
                "itemName": "Funko PoP! MArvel",
                "price": 9.99,
                "customerStarRating": "4.5 out of 5 stars",
                "customerReview": "5,006 ratings",
                "linkUrl": "http://www.amazon.com/gp/product/B07JLCLVRJ/ref=silver_xx_cont_revecalc",
                "imageUrl": "https://m.media-amazon.com/images/I/61Y6N4hBjDL._SL120_.jpg",
                "otherDetails": [
                    "Get it as soon as Tue, Mar 29",
                    "$3.99 shipping",
                    "Only 1 left in stock - order soon."
                ]
            },
            {
                "asin": "B08XMY2DWM",
                "itemName": "Party House Masters of The Universe Mini Figurines Cake Toppers ",
                "price": 7.4,
                "priceShipping": 0,
                "inventoryWarning": "",
                "customerStarRating": "5 out of 5 stars",
                "customerReview": "1,105 ratings",
                "linkUrl": "http://www.amazon.com/gp/product/B08XMY2DWM/ref=silver_xx_cont_revecalc",
                "imageUrl": "https://m.media-amazon.com/images/I/61Y6N4hBjDL._SL120_.jpg",
                "otherDetails": [
                    "Get it as soon as Tue, Mar 29",
                    "$2.99 shipping",
                    "Only 10 left in stock - order soon."
                ]
            }
        ]
    },
    "rid": "60f12c1a0cf24280ed03be5e",
    "dateProcessed": 1626418203388,
    "domain": "www.amazon.com"
    "totalCreditsDeducted": 1
}
OBTENER ASINS DEL VENDEDOR CONSULTA DEVOLUCIÓN DE LLAMADA RESPUESTA ATRIBUTOS JSON
Nombre del AtributoDetalles
EstadoEl estado de la solicitud.
respuesta paraValor de “sellerinfo” para el resultado de la consulta de información del vendedor.
permitidoEl recuento de solicitudes permitidas actualmente. Se reinicia mensualmente.
diarioPermitidoEl recuento de solicitudes diarias permitidas actualmente. Se reinicia diariamente.
mensajeIdLa identificación del mensaje (si corresponde).
mensajeEl mensaje real (si lo hay). Consulte Mensajes de error.
librarLa identificación de la solicitud. Esto se puede utilizar en la consulta Obtener como clave.
dominioEl dominio de Amazon correspondiente al Vendedor.
totalCréditosDeducidosEste campo indica cuántos créditos API de Amzpecty se utilizaron para cumplir con esta solicitud.
fechaProcesadoLa fecha en que se procesó la solicitud en formato de hora Unix.
datos.sellerIdLa identificación del vendedor.
datos.estadodebúsquedaEl estado de la búsqueda. “en curso” o “completado”
data.completedAsinsEl número de Asins recuperados. Límite máximo de 2,400 Asins solo incluso si el vendedor tiene más de 2,400 Asins. Tenga en cuenta que totalAsins puede no ser igual a completeAsins por varios motivos. Consulte el campo searchStatus para conocer el estado de búsqueda.
datos.negocioInfoMapa de pares de valores clave, por ejemplo
Nombre comercial = 9103-6152 Quebec Inc.
Dirección comercial = 558A Hempstead Ave WEST TOWN Nueva York 112233 EE. UU.
datos.totalAsinsEl número total de Asins que tiene este vendedor.
datos.asins[]La lista de Asins que tiene este vendedor.
asines[n].asinEl Asin del artículo.
asins[n].nombre del artículoEl nombre del artículo del Asin.
asins[n].precioEl precio mostrado del Asin.
asins[n].clienteStarRatingLa calificación de estrellas del cliente de Asin
asins[n].Revisión del clienteEl recuento de reseñas de clientes sobre Asin.
asins[n].linkUrlEl enlace del Asin
asins[n].imageUrlLa URL de la imagen del Asin.
asins[n].otrosDetalles[n]Lista de otros detalles como información de envío, tarifas de envío, advertencia de stock, etc.

OBTENER EL RESULTADO DE ASINS DEL VENDEDOR MEDIANTE ID DE SOLICITUD

La solicitud para obtener el resultado del Asins del vendedor mediante el ID de solicitud (eliminar).

Tenga en cuenta que puede llamar a esto para recuperar datos de resultados incluso si Amzpecty todavía está buscando datos y no está 100% completo. Puede consultar el campo searchStatus para conocer el estado de la búsqueda.

Note: Por favor, evite realizar llamadas sucesivas en intervalos muy cortos. Cada al menos 30 segundos es nuestro intervalo de llamada recomendado.

DEDUCCIÓN DE CRÉDITO

0 (cero) deducción de crédito por la llamada Get.

SOLICITAR
URI /api/query/seller/getasins/{ID DE VENDEDOR}? dominio={dominio}&clavesecreta={clavesecreta} {SELLER ID} – obligatorio – el ID de vendedor del vendedor objetivo {dominio} – opcional – el valor predeterminado es www.amazon.com si no se especifica. Ver Dominios de Amazon compatibles para la lista.
Ejemplo /api/query/getsellerasin/rid/60f12c1a0cf24280ed03c11d?secretKey=XXXXXXXXXX
RESPUESTA

See Obtenga datos de muestra JSON de devolución de llamada de consulta de Asins del vendedor

¿Le fue útil este artículo? No
¿Cómo podemos ayudarle?