1. Introduction
Our Amazon merchant API is a RESTful service based on JSON format (or others) that provides you with market price and product data on your portfolio items. In order to receive data on one or more offers for products your system asks the API with a specific identifier (GTIN, id, term, URL) and country code (de, us, etc.). Our service visits Google Shopping, searches for the product offers and extracts the relevant information. Once this process is done, your system can download the data and use it for further processing.
Available Amazon marketplaces:
- us, ca, mx, br, gb, uk, de, es, fr, it, jp, cn, in, ae, au, at*, ch*
* at and ch use DE marketplace but with AT or CH address
2. Endpoints
2.1 Get ASIN (Amazon Standard Identification Number) by GTIN (Global Trade Item Number)
-
Path: /get-offers
-
Input parameters:
- gtin - Global Trade Item Number
- country - alpha-2 country code of the source to request from (de, at, us, etc.)
-
Response (product found):
{
“error”: false,
“asin”: “B09Q67SVBG”
}
-
Response (product not found):
{
“error”: false,
“message”: “Gtin not found”
}
2.2 Get offers
- Path:
/get-product
- Input parameters:
- asin - Amazon Standard Identification Number
- country - alpha-2 country code of the source to request from (de, at, us, etc.)
- Response (product found):
{
“error”: false,
“product”: {
“asin”: “B09Q67SVBG”,
“url”: “https://www.amazon.de/dp/B09Q67SVBG”,
“main_category”: {
“name”: “Elektronik & Foto”,
“node_id”: “562066”,
“rank”: “46”
},
“category”: [“Elektronik & Foto”, “Handys & Zubehör”, “Handys & Smartphones”, “Simlockfreie Handys”],
“brand”: {
“name”: “HUAWEI”,
“brand_id”: null
},
“review_rating”: “4.7”,
“review_count”: 4,
“seller_type”: “merchant”,
“bsr”: [{
“rank”: “46”,
“node_id”: “562066”,
“name”: “Elektronik & Foto”
}, {
“rank”: “365”,
“node_id”: “361588011”,
“name”: “Bluetooth-Kopfhörer”
}, {
“rank”: “634”,
“node_id”: “15326400031”,
“name”: “Simlockfreie Handys”
}],
“name”: “HUAWEI P50 Pro - Smartphone, 50 MP True-Chroma Camera, 6,6 Zoll OLED Display, 120 Hz Aktualisierungsrate, 66W HUAWEI Supercharge, 8GB RAM+256GB ROM, 4360 mAh, Cocoa Gold”,
“parent_asin”: “B09Q67SVBG”,
“currency”: “EUR”,
“shipping”: 0,
“buybox_price”: 906.71,
“retail_price”: 1199,
“buybox_owner”: “ZOXS GmbH”,
“buybox_owner_id”: “A10RUDMQMTB3T4”,
“no_shops”: 12,
“is_available”: true,
“on_amazon_since”: null,
“features”: [“True-Form Dual-Matrix-Kamera: 200x True-Steady-Aufnahme,Super Farbfilter System, True-Focus schnelle Aufnahme, Ultraweitwinkel AF Selfie.”, “Ikonisches Dual-Matrix-Kamera Design: “Das Fotowunder ist zurück” - Dual-Matrix-Kamera Design, HUAWEI Flaggschiff-Smartphone,mit überlegendem iknoischen Design”, “Die HUAWEI XD-Optik: Ermöglicht Smartphone-Fotografie mit höherer Klarheit und die optimierte HUAWEI XD Fusion Pro Image Engine trägt zur Reproduktion unzähliger Bilddetails bei. Die Hauptkamera-Matrix zeigt Ihnen die Welt in ihren echten Farben und die SuperZoom-Matrix hält Bilder in atemberaubender Klarheit fest – von nah oder fern, als Weitwinkel- oder Nahaufnahme.”, “Leichteres Gewicht, bessere Handhabung: Der größere Bildschirm und Akku sind in einem kompakten Gehäuse untergebracht. Das macht das HUAWEI P50 Pro leichter als die Vorgängergeneration, und es liegt besser in der Hand. Auch der 66W kabelgebundene und 50W drahlose SuperCharger mit einer 4360mAh großen Batterie ist mit dabei.”],
“description_text”: “”,
“isbn”: “”,
“upc”: “”,
“quantity”: 3,
“images”: [“https://m.media-amazon.com/images/I/51PwSiuTOQL.AC_SL1000.jpg”, “https://m.media-amazon.com/images/I/319CRtQvzIL.AC_SL1000.jpg”, “https://m.media-amazon.com/images/I/51iCapyarSL.AC_SL1000.jpg”, “https://m.media-amazon.com/images/I/51Pi0OHgD8L.AC_SL1000.jpg”, “https://m.media-amazon.com/images/I/519pxXOJdvL.AC_SL1000.jpg”, “https://m.media-amazon.com/images/I/61JSalrzP4L.AC_SL1000.jpg”],
“thumbs”: [“https://m.media-amazon.com/images/I/31n7KAuLaRL.AC_US40.jpg”, “https://m.media-amazon.com/images/I/11njANqJsPL.AC_US40.jpg”, “https://m.media-amazon.com/images/I/31C2Sd1nHfL.AC_US40.jpg”, “https://m.media-amazon.com/images/I/314OEBu-4pL.AC_US40.jpg”, “https://m.media-amazon.com/images/I/41aujjF3ziL.AC_US40.jpg”, “https://m.media-amazon.com/images/I/41vzGVPgYSL.AC_US40.jpg”],
“videos”: [{
“thumbUrl”: “https://m.media-amazon.com/images/I/61+h1lGRxYL.SS40_BG85,85,85_BR-120_PKdp-play-icon-overlay__.jpg”,
“title”: “MKT_P50_Product Video_HQ_MKT_AJ_Function Motion Graphics in Keynote”,
“languageCode”: “de_DE”,
“url”: “https://m.media-amazon.com/images/S/vse-vms-transcoding-artifact-eu-west-1-prod/6dd801a9-fae6-45c1-ba96-19a2321e7ee4/default.jobtemplate.mp4.480.mp4”,
“videoHeight”: “480”,
“videoWidth”: “854”
}],
“variants”: [{
“asin”: “B09Q69QT5X”,
“attributes”: {
“color”: “HUAWEI P50 Pro”,
“style”: “Golden Black”
}
}, {
“asin”: “B09QRWXYMC”,
“attributes”: {
“color”: “HUAWEI P50 Pocket + FreeBuds Pro”,
“style”: “Weiß + Silber”
}
}, {
“asin”: “B09Q68CT33”,
“attributes”: {
“color”: “HUAWEI P50 Pocket”,
“style”: “Gold”
}
}, {
“asin”: “B09Q68KPGH”,
“attributes”: {
“color”: “HUAWEI P50 Pocket”,
“style”: “White”
}
}, {
“asin”: “B09QS2NSYS”,
“attributes”: {
“color”: “HUAWEI P50 Pro + FreeBuds Pro”,
“style”: “Golden Black + Silber”
}
}, {
“asin”: “B09QRFR1KM”,
“attributes”: {
“color”: “HUAWEI P50 Pro + FreeBuds Pro”,
“style”: “Cocoa Gold + Silber”
}
}, {
“asin”: “B09QRWLJN8”,
“attributes”: {
“color”: “HUAWEI P50 Pocket + FreeBuds Pro”,
“style”: “Gold + Silber”
}
}, {
“asin”: “B09Q67SVBG”,
“attributes”: {
“color”: “HUAWEI P50 Pro”,
“style”: “Cocoa Gold”
}
}],
“specs”: {
“wireless_provider”: “Entsperrt”,
“compatible_devices”: “Earphone”,
“included_components”: “Schnellstartanleitung, TP Schutzfilm, Netzteil & USB-C Kabel, Flexible transparente Schutzhülle, HUAWEI P50 Pro Mehr anzeigen”,
“brand”: “HUAWEI”,
“model_name”: “P50 Pro”,
“battery_power”: “4360 Unbekannt”,
“cellular_technology”: “LTE”,
“camera_description”: “Front, Rück”,
“sim_card_size”: “Nano”,
“memory_storage_capacity”: “8 GB”
},
“product_details”: {
“Batterien”: “1 Lithium-Polymer Batterien erforderlich (enthalten).”,
“Produktabmessungen”: “0.85 x 7.28 x 15.88 cm; 195 Gramm”,
“Im Angebot von Amazon.de seit”: “26. Januar 2022”,
“Hersteller”: “HUAWEI”,
“ASIN”: “B09Q67SVBG”,
“Modellnummer”: “51096VTC”
},
“additional_info”: {},
“technical_details”: {},
“length”: “0.85”,
“width”: “7.28”,
“depth”: “15.88”,
“length_unit”: “cm”,
“weight”: “195”,
“weight_unit”: “g”
}
}
2.3 Get offers
List of possible errors:
- missing parameter - not all required parameters are present
- unknown country - country not supported
- not subscribed to source - client not subscribed to source / country