1. Accueil
  2. Docs
  3. Documentation Amzpecty
  4. Spécifications de l'API Amzpecty
  5. API d'informations sur le vendeur

API d'informations sur le vendeur

AJOUTER UN ID VENDEUR À LA QUEUE DE REQUÊTE D'INFORMATIONS SUR LE VENDEUR

La demande d’ajout d’un identifiant de vendeur à la file d’attente de requêtes d’informations sur le vendeur.

DÉDUCTION DE CRÉDIT

1 (un) crédit de déduction après récupération réussie des données.

DEMANDE
URI /api/query/seller/{ID VENDEUR} ? domaine={domaine}&secretKey={secretKey} {SELLER ID} – obligatoire – l'identifiant du vendeur cible {domaine} – facultatif – par défaut www.amazon.com s'il n'est pas spécifié. Voir Domaines Amazon pris en charge pour la liste.
En-tête HTTP (facultatif) AMZPECTY_CALLBACK_URL={Votre URL de rappel}
Exemple /api/query/seller/A3A5YZ4E94TE9K?secretKey=XXXXXXXXXX
RÉPONSE
En-têtes
Type de support application / json
Données JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerinfo",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03be54",
    "dateProcessed": null,
    "domain": null
}
RAPPEL DE REQUÊTE D'INFORMATIONS SUR LE VENDEUR ÉCHANTILLONS DE DONNÉES JSON
En-têtes
Type de support application / json
Données 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
}
INFORMATIONS SUR LE VENDEUR REQUÊTE RÉPONSE DE RAPPEL ATTRIBUTS JSON
Nom d'attributDétails
statutsLe statut de la demande.
réponsepourValeur « sellerinfo » pour le résultat de la requête Informations sur le vendeur.
permisLe nombre de demandes actuellement autorisées. Se réinitialise mensuellement.
quotidiennementAutoriséNombre de demandes quotidiennes actuellement autorisées. Se réinitialise quotidiennement.
ID du messageL'identifiant du message (le cas échéant).
messageLe message réel (le cas échéant). Veuillez vous référer aux messages d'erreur.
débarrasserL’identifiant de la demande. Cela peut être utilisé dans la requête Get comme clé.
domaineLe domaine Amazon correspondant pour le vendeur.
totalCréditsDéduitCe champ indique combien de crédits API Amzpecty ont été utilisés pour répondre à cette demande.
dateTraitéDate à laquelle la demande a été traitée au format horaire Unix.
data.sellerIdL'identifiant du vendeur.
data.sellerNameLe nom en ligne du vendeur.
data.logoUrlL'url du logo du vendeur.
data.businessInfoCarte des paires clé-valeur, par exemple
Nom de l'entreprise=9103-6152 Québec Inc
Adresse professionnelle = 558A Hempstead Ave WEST TOWN New York 112233 US
( autre_clé = autre_valeur )
données.à proposA propos du vendeur.
data.feedbackStarListe des paires clé-valeur des marques de produits proposées par le vendeur.
données.productCountLe nombre de produits du vendeur
** obsolète le 2/16/2024 **
data.productBrands[]
Liste des paires clé-valeur des marques de produits proposées par le vendeur.
data.feedbackPositive30daysCommentaires positifs du vendeur pendant une période de 30 jours.
data.feedbackPositive90daysCommentaires positifs du vendeur pendant une période de 90 jours.
data.feedbackPositive12moisLe vendeur a fait un retour positif sur une période de 12 mois.
data.feedbackPositiveLifetimeLe vendeur a des commentaires positifs pour la période de vie.
data.feedbackNeutral30daysCommentaires neutres du vendeur pendant une période de 30 jours.
data.feedbackNeutral90daysCommentaires neutres du vendeur pendant une période de 90 jours.
data.feedbackNeutral12moisCommentaires neutres du vendeur pendant une période de 12 mois.
data.feedbackNeutralLifetimeCommentaires neutres du vendeur pour une période de vie.
data.feedbackNegative30daysCommentaires négatifs du vendeur pendant une période de 30 jours.
data.feedbackNegative90daysCommentaires négatifs du vendeur pendant une période de 90 jours.
data.feedbackNegative12monthsLe vendeur a des commentaires négatifs pendant une période de 12 mois.
data.feedbackNegativeLifetimeCommentaires négatifs du vendeur pour la période de vie.
data.feedbackCount30daysLes commentaires du vendeur comptent pour une période de 30 jours.
data.feedbackCount90daysLes commentaires du vendeur comptent pour une période de 90 jours.
data.feedbackCount12moisLes commentaires du vendeur comptent pour une période de 12 mois.
data.feedbackCountLifetimeLes commentaires du vendeur comptent pour la durée de vie.

OBTENIR LE RÉSULTAT DES INFORMATIONS SUR LE VENDEUR PAR ID DE DEMANDE

La demande pour obtenir le résultat des informations sur le vendeur par Request Id (rid).

DÉDUCTION DE CRÉDIT

0 (zéro) déduction de crédit pour l’appel Get.

DEMANDE
URI /api/query/getsellerinfo/rid/{rid}?secretKey={secretKey} {rid} – demande d'identifiant à partir de la réponse /api/query/estprofit/
Exemple /api/query/ getsellerinfo/rid/60f12c1a0cf24280ed03c11d?secretKey=XXXXXXXXXX
RÉPONSE

See Données d'exemple JSON de rappel de requête d'informations sur le vendeur

AJOUTER UN ID VENDEUR POUR OBTENIR LA QUEUE DE REQUÊTE ASINS DU VENDEUR

La demande d’ajout d’un identifiant de vendeur pour obtenir la file d’attente de requêtes Get Seller Asins.

: L'API Amzpecty ne peut obtenir que jusqu'à un maximum de 2,400 XNUMX Asins.

DÉDUCTION DE CRÉDIT

1 (un) crédit de déduction après la récupération réussie d'une page de données Asin. Chaque page contient un maximum de 1 Asins.

DEMANDE
URI /api/query/seller/getasins/{ID VENDEUR} ? domaine={domaine}&secretKey={secretKey} {SELLER ID} – obligatoire – l'identifiant du vendeur cible {domaine} – facultatif – par défaut www.amazon.com s'il n'est pas spécifié. Voir Domaines Amazon pris en charge pour la liste.
En-tête HTTP (facultatif) AMZPECTY_CALLBACK_URL={Votre URL de rappel}
Exemple /api/query/seller/getasins/A3A5YZ4E94TE9K?secretKey=XXXXXXXXXX
RÉPONSE
En-têtes
Type de support application / json
Données JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerasins",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03b000",
    "dateProcessed": null,
    "domain": null
}
OBTENIR DES DONNÉES D'EXEMPLES JSON DE RAPPEL DE REQUÊTE ASINS DU VENDEUR
En-têtes
Type de support application / json
Données 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
}
OBTENIR LA RÉPONSE DE RAPPEL À LA REQUÊTE ASINS DU VENDEUR ATTRIBUTS JSON
Nom d'attributDétails
StatutLe statut de la demande.
réponsepourValeur « sellerinfo » pour le résultat de la requête Informations sur le vendeur.
permisLe nombre de demandes actuellement autorisées. Se réinitialise mensuellement.
quotidiennementAutoriséNombre de demandes quotidiennes actuellement autorisées. Se réinitialise quotidiennement.
ID du messageL'identifiant du message (le cas échéant).
messageLe message réel (le cas échéant). Veuillez vous référer aux messages d'erreur.
débarrasserL’identifiant de la demande. Cela peut être utilisé dans la requête Get comme clé.
domaineLe domaine Amazon correspondant pour le vendeur.
totalCréditsDéduitCe champ indique combien de crédits API Amzpecty ont été utilisés pour répondre à cette demande.
dateTraitéDate à laquelle la demande a été traitée au format horaire Unix.
data.sellerIdL'identifiant du vendeur.
data.searchStatusL'état de la recherche. « en cours » ou « terminé »
data.completedAsinsLe nombre d'Asins récupérés. Limite maximale de 2,400 2,400 Asins uniquement, même si le vendeur possède plus de XNUMX XNUMX Asins. Notez que totalAsins peut ne pas être égal àcompleteAsins pour diverses raisons. Veuillez vous référer au champ searchStatus pour connaître l'état de la recherche.
data.businessInfoCarte des paires clé-valeur, par exemple
Nom de l'entreprise=9103-6152 Québec Inc
Adresse professionnelle = 558A Hempstead Ave WEST TOWN New York 112233 US
data.totalAsinsLe nombre total d’Asins que possède ce vendeur.
données.asins[]La liste des Asins que possède ce vendeur.
asins[n].asinL'Asin de l'article
asins[n].itemNameLe nom de l'article de l'Asin
asins[n].prixLe prix affiché de l'Asin
asins[n].customerStarRatingLe classement par étoiles des clients de l'Asin
asins[n].customerReviewLe nombre d'avis clients sur Asin
asins[n].linkUrlLe lien de l'Asin
asins[n].imageUrlL'url de l'image de l'Asin
asins[n].otherDetails[n]Liste d'autres détails tels que les informations d'expédition, les frais d'expédition, les avertissements de stock, etc.

OBTENIR LE RÉSULTAT DU VENDEUR ASINS PAR ID DE DEMANDE

La demande pour obtenir le résultat du vendeur Asins par Request Id (rid).

Notez que vous pouvez appeler ceci pour récupérer les données de résultats même si Amzpecty recherche toujours des données et n'est pas terminé à 100 %. Vous pouvez vous référer au champ searchStatus pour connaître l’état de la recherche.

Notes: Veuillez éviter de passer des appels successifs à très court intervalle. Toutes les 30 secondes au moins correspond à notre intervalle d’appel recommandé.

DÉDUCTION DE CRÉDIT

0 (zéro) déduction de crédit pour l’appel Get.

DEMANDE
URI /api/query/seller/getasins/{ID VENDEUR} ? domaine={domaine}&secretKey={secretKey} {SELLER ID} – obligatoire – l'identifiant du vendeur cible {domaine} – facultatif – par défaut www.amazon.com s'il n'est pas spécifié. Voir Domaines Amazon pris en charge pour la liste.
Exemple /api/query/getsellerasin/rid/60f12c1a0cf24280ed03c11d?secretKey=XXXXXXXXXX
RÉPONSE

See Obtenir des exemples de données JSON de rappel de requête Asins du vendeur

Cet article vous a-t-il été utile ? Oui Non
Comment pouvons-nous vous aider ?