1. Accueil
  2. Docs
  3. Documentation Amzpecty
  4. Spécifications de l'API Amzpecty
  5. API d'instantané ASIN

API d'instantané ASIN

AJOUTER ASIN/ISBN À LA QUEUE DE REQUÊTES D'INSTANTANÉS ASIN

La demande d'ajout d'un ASIN/ISBN à la file d'attente de requêtes Asin Snapshot.

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/add/{ASIN/ISBN}?domain={domain}&secretKey={secretKey}&condition={condition} {ASIN/ISBN} – obligatoire – l'ASIN ou l'ISBN à ajouter à la liste de suivi {domaine} – facultatif – par défaut www.amazon.com s'il n'est pas spécifié. Voir Domaines Amazon pris en charge pour la liste.
{condition} – facultatif – par défaut, nouveau si nul/non spécifié
valeurs valides [neufs, d'occasion, de collection, remis à neuf, tous]
{excluremoq} – facultatif – la valeur par défaut est false si nulle/non spécifiée. valeurs valides [vrai, faux]. Si c'est vrai, Amzpecty exclura la recherche de moq.
En-tête HTTP (facultatif) AMZPECTY_CALLBACK_URL={Votre URL de rappel}
Exemple /api/query/add/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx &condition=used&excludemoq=false
RÉPONSE
En-têtes
Type de support application / json
Données JSON
JSON
{
    "status": "OK",
    "allowed": 4971,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "58eb4fb8bfc2333894ce7dc7",
    "dateProcessed": null
}

Notes: Lors du rappel, le rid peut être utilisé pour lier les données de rappel à l'appel de la demande d'origine.

RAPPEL DE REQUÊTE D'INSTANTANÉ ASIN

DEMANDE DE RAPPEL DE REQUÊTE D'INSTANTANÉ ASIN
URI Exemple : https://your.server.com/amzpecty_result {Veuillez fournir l'URL dans la page Préférences} L'URL doit être activée pour SSL. AMZPECTY-API-SECRET-KEY (nom de l'en-tête) – l'en-tête de clé secrète sera inclus pour que le serveur de rappel valide l'origine de la demande
Type de support application / json
RAPPEL DE REQUÊTE D'INSTANTANÉ ASIN DONNÉES D'EXEMPLES JSON
En-têtes
Type de support application / json
Données JSON
JSON
{
    "status": "OK",
    "responsefor": "asinsnapshot",
    "allowed": 4992,
    "dailyAllowed": 500,
    "messageId": null,
    "message": null,
    "data": {
        "queryAsin": "B01MYEYYYY",
        "asin": "B01MYEYYEE",
        "itemName": "Nest 9750016 T3016US Thermostat Black",
        "brand": "by Nest",
        "salesRank": 11346,
        "totalQty": 150,
        "buyboxPrice": "237.15",
        "buyboxSellerName": "JJJ SELLER",
        "buyboxSellerId": "AAW8R82WBLFL9",
        "buyboxItemCondition": "New",
        "totalFBA": 6,
        "totalFBM": 7,
        "maxPrice": 599,
        "minPrice": 237.79,
        "avgPrice": 293.05,
        "isAmazonSelling": false,
        "isAmazonWarehouseSelling": false,
        "customerStarRating": "4.5 out of 5 stars",
        "customerReview": "5,006 ratings",
        "totalOffers": 1,
        "pageNotFound": false,
        "hasVariations": true,
        "unavailable": false,
        "offers": [
            {
                "sellerName": "cables4computer",
                "condition": "New",
                "price": 237.79,
                "priceShipping": 0,
                "priceTotal": 237.79,
                "fba": false,
                "inventoryCount": 11,
                "conditionNote": "",
                "ratingStar": 4.5,
                "sellerRating": "89% positive over the past 12 months. (13,223 total ratings)",
                "prime": false,
                "sellerId": "A3VZC5G7U3OWU4",
                "offerId": "8pwpOXydEI1znRNLYpU",
                "moq": false,
                "moqvalue": 0
            }
        ]
    },
    "rid": "5d6e0b63e4b0e29d7d7d232c",
    "dateProcessed": 1567492992552,
    "domain": "www.amazon.com",
    "totalCreditsDeducted": 1
}
RÉPONSE DE RAPPEL À LA REQUÊTE INSTANTANÉ ASIN 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.queryAsinL'ASIN spécifié dans l'appel ADD.
données.asinL'ASIN du produit. L'ASIN peut être différent de l'ASIN spécifié dans l'appel ADD.
Par exemple, en cas d'ASIN fusionné ou d'ASIN supprimé.
données. nom de l'articleLe nom de l'élément du produit.
données. marqueLe nom de marque du produit.
données. classement des ventesLe prix maximum de toutes les offres de ce produit.
données. Quantité totaleLa quantité totale estimée du produit.
données. buyboxPrixLe prix actuel de la boîte d'achat du produit, hors frais d'expédition.
données. buyboxNom du vendeurLe nom actuel du vendeur buybox du produit.
données. buyboxSellerIdL’identifiant du vendeur buybox.
données. buyboxItemConditionL’état de l’article de la boîte d’achat.
données. totalFBALe nombre total de vendeurs Expédié par Amazon.
données. totalFBMLe nombre total de vendeurs FBM.
données. prix maxLe prix maximum de toutes les offres de ce produit.
données. Prix ​​minLe prix minimum de toutes les offres de ce produit.
données. PrixmoyLe prix moyen de toutes les offres de ce produit.
données. isAmazonVenteIndicateur de commodité si Amazon a une offre pour cet article.
données. isAmazonWarehouseVenteIndicateur de commodité si Amazon Warehouse propose une offre pour cet article.
données. CustomerStarRatingNote du client. Exemple de valeur « 4.5 étoiles sur 5 »
données. Avis clientNombre d’avis clients. Exemple de valeur « 5,006 XNUMX notes »
données. totalOffresLe nombre total d'offres de ce produit.
données.indisponiblesSi c'est vrai, cet indicateur indique qu'il n'y a aucune offre pour ce produit répertorié.
data.hasVariationsSi c'est vrai, cet indicateur indique qu'il existe d'autres variantes de ce produit.
data.pageNotFoundSi c'est vrai, cet indicateur indique que l'ASIN n'est actuellement pas répertorié.
data.imageUrlL'URL de l'image du produit.
données. des offres[]La liste des offres du produit.
offres[n]. Nom du VendeurLe nom du vendeur proposant le produit.
offres[n]. identifiant du vendeurL'identifiant du vendeur de cette offre.
offres[n]. conditionL'état du produit.
offres[n]. prixLe prix du produit.
offres[n]. prixExpéditionLes frais d'expédition de cette offre de produit.
offres[n]. prixTotalLa somme du prix et des frais d'expédition de cette offre de produit.
offres[n]. fbaEst-ce que l'offre est le drapeau FBA.
offres[n]. l'inventaireLa quantité disponible offerte par le vendeur de ce produit.
offres[n]. étatRemarqueLa note sur l'état du produit. (Si seulement)
offres[n]. noteStarLe nombre d'étoiles de ce vendeur proposant le produit.
offres[n]. vendeurNoteLa note de ce vendeur proposant le produit.
offres[n]. primeLe drapeau indiquant si cette offre est éligible au prime.
offres[n]. identifiant du vendeurL'identifiant du vendeur de cette offre.
offres[n]. ID de l'offreL'identifiant de cette offre
offres[n]. moqLe drapeau de quantité minimum de commande de cette offre. (Si le vendeur impose MOQ)
offres[n]. valeur moqLa valeur réelle de la quantité minimale de commande de cette offre. (Si le vendeur impose MOQ)

OBTENIR LE RÉSULTAT DE L'INSTANTANÉ ASIN PAR ASIN/ISBN

La demande pour obtenir le dernier résultat Asin Snapshot par ASIN/ISBN.

DÉDUCTION DE CRÉDIT

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

DEMANDE
URI /api/query/get/asin/{ASIN/ISBN}?domain={domain}&secretKey={secretKey} {ASIN/ISBN} – l'ASIN permettant d'obtenir la liste de suivi la plus récente {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/get/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx
RÉPONSE

See Exemples de données JSON de rappel de requête d'instantané Asin

OBTENIR LE RÉSULTAT DE L'INSTANTANÉ ASIN PAR ID DE DEMANDE

La demande pour obtenir le dernier résultat d'Asin Snapshot par Request Id (rid).

DÉDUCTION DE CRÉDIT

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

DEMANDE
URI {rid} – identifiant de demande de la réponse /api/query/add/ {domain} – 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/get/rid/58eb0033bfc238234367eb92?domain=www.amazon.com&secretKey=xxxxxxxxxx
RÉPONSE

See Exemples de données JSON de rappel de requête d'instantané Asin

OBTENIR LE RÉSULTAT DE L'INSTANTANÉ ASIN PAR ID DE DEMANDE

La demande pour obtenir le dernier résultat d'Asin Snapshot par Request Id (rid).

DÉDUCTION DE CRÉDIT

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

DEMANDE
URI {rid} – identifiant de demande de la réponse /api/query/add/ {domain} – 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/get/rid/58eb0033bfc238234367eb92?domain=www.amazon.com&secretKey=xxxxxxxxxx
RÉPONSE

See Exemples de données JSON de rappel de requête d'instantané Asin

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