L'API Amzpecty peut analyser tous les ASIN d'une URL de résultat de recherche Amazon particulière via ce module API.
AJOUTER UNE URL POUR OBTENIR DES ASINS PAR LA QUEUE DE REQUÊTE D'URL
La demande d'ajout d'une URL à la file d'attente de requêtes Get Asins By URL. L'URL est une URL de résultat de recherche Amazon.
Attention : l'API Amzpecty ne peut obtenir qu'un maximum de 2,400 XNUMX Asins.
Limitations : le nombre d'ASIN récupérés peut varier du nombre réel d'ASIN d'Amazon en raison de divers facteurs tels que l'emplacement de recherche, la dynamique des listes Amazon, etc.
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. Le nombre d'Asin par page peut varier.
DEMANDE
| URI | /api/query/getasinsbyurl?secretKey={secretKey} | |
| Method | POSTEZ | |
| Paramètres POST | searchurl={url} où {url} – obligatoire – l'URL cible, par exemple https://www.amazon.com/s?k=funko&i=warehouse-deals | |
| En-tête HTTP (facultatif) | AMZPECTY_CALLBACK_URL={Votre URL de rappel} | |
| Exemple | /api/query/getasinsbyurl | |
RÉPONSE
| En-têtes | |
| Type de support | application / json |
| Données JSON |
{
"status": "OK",
"responsefor": "getasinsbyurl",
"allowed": 4992,
"dailyAllowed": 4992,
"messageId": null,
"message": null,
"data": null,
"rid": "60f126e20cf24280ed03b000",
"dateProcessed": null,
"domain": null
}Notes: Lors du rappel, le rid peut être utilisé pour lier les données de rappel à l'appel de la demande d'origine.
OBTENIR DES ASINS PAR URL DE REQUETE DE RAPPEL DE DONNÉES JSON
| En-têtes | |
| Type de support | application / json |
| Données JSON |
{
"status": "OK",
"responsefor": "getasinsbyurl",
"allowed": 4986,
"dailyAllowed": 4986,
"messageId": null,
"message": null,
"data": {
"statusInt": 2,
"status": "Completed",
"searchUrl": " https://www.amazon.com/s?k=funko&i=warehouse-deals ",
"expectedTotalAsins": 732,
"actualAsinsRetrieved": 732,
"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 LES ASINS DU VENDEUR PAR URL REQUÊTE RÉPONSE DE RAPPEL ATTRIBUTS JSON
| Nom d'attribut | Détails |
|---|---|
| statuts | Le statut de la demande. |
| réponsepour | Valeur « getasinsbyurl » pour le résultat de la requête Obtenir les Asins par URL. |
| permis | Le nombre de demandes actuellement autorisées. Se réinitialise mensuellement. |
| quotidiennementAutorisé | Nombre de demandes quotidiennes actuellement autorisées. Se réinitialise quotidiennement. |
| ID du message | L'identifiant du message (le cas échéant). |
| message | Le message réel (le cas échéant). Veuillez vous référer aux messages d'erreur. |
| débarrasser | L’identifiant de la demande. Cela peut être utilisé dans la requête Get comme clé. |
| domaine | Le domaine Amazon correspondant pour le vendeur. |
| totalCréditsDéduit | Ce 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.sellerId | L'identifiant du vendeur. |
| data.statusInt | Le statut de la recherche sous forme int. 0 pour "En file d'attente", 1 pour "Traitement", 2 pour "Terminé" ou 3 pour "Erreur" |
| données.statut | L'état de la recherche. "En file d'attente", "Traitement", "Terminé" ou "Erreur" |
| data.actualAsinsRécupéré | Le nombre d'Asins récupérés. Limite maximale de 2,400 2,400 Asins uniquement, même si l'URL contient plus de XNUMX XNUMX Asins. Noter que actualAsinsRécupéré pourrait ne pas être égal à attenduTotalAsins pour diverses raisons. Veuillez vous référer au sTatus champ pour l’état de recherche. |
| data.expectedTotalAsins | Le nombre total d’Asins de cette URL. |
| données.asins[] | La liste des Asins que possède ce vendeur. |
| asins[n].asin | L'Asin de l'article |
| asins[n].itemName | Le nom de l'article de l'Asin |
| asins[n].prix | Le prix affiché de l'Asin |
| asins[n].customerStarRating | Le classement par étoiles des clients de l'Asin |
| asins[n].customerReview | Le nombre d'avis clients sur Asin |
| asins[n].linkUrl | Le lien de l'Asin |
| asins[n].imageUrl | L'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 ASINS PAR URL RÉSULTAT PAR ID DE DEMANDE
La requête pour obtenir le résultat Get Asins By URL par Request Id (débarrasser).
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 sTatus champ pour le statut de la recherche.
Remarque : 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/getasinsbyurl/rid/{rid}?secretKey={secretKey} | {rid} – demande d'identifiant à partir de la réponse /api/query/getasinsbyurl/ |
| Exemple | /api/query/ getasinsbyurl/rid/60f12c1a0cf24280ed03c122?secretKey=XXXXXXXXXX | |
RÉPONSE
See OBTENIR DES ASINS PAR URL DE REQUETE DE RAPPEL DE DONNÉES JSON
