शॉपिंग · Amazon
Amazon Deals API
Amazon Deals API से आपको लाइव Amazon डेटा ठीक उसी पल मिलता है जब आप पूछते हैं, साफ़ स्ट्रक्चर्ड रूप में – आपके ऐप, स्प्रेडशीट या AI असिस्टेंट के लिए तैयार। न स्क्रैपिंग, न रखरखाव।
हर महीने 100 फ़्री रिक्वेस्ट · क्रेडिट कार्ड की ज़रूरत नहीं · सभी प्लेटफ़ॉर्म के लिए एक API key
मुख्य तथ्य
अपडेट:
Amazon का डील्स पेज मार्केटप्लेस की सीमित समय वाली छूटों को एक जगह लाता है: countdown वाली Lightning Deals, Best Deals, Prime-exclusive ऑफ़र और उन पर बने सीज़नल इवेंट। everydata.io का Amazon Deals API किसी भी मार्केटप्लेस के लिए यह ग्रिड लाइव पढ़ता है और हर डील को मौजूदा कीमत, रेफ़रेंस कीमत, बचत और डील स्टेट के साथ लौटाता है। डिपार्टमेंट, छूट की रेंज, स्टार रेटिंग, प्राइस रेंज और Prime access के फ़िल्टर सीधे पेज के रिफ़ाइनमेंट से मेल खाते हैं, और एक सहायक endpoint बताता है कि इस समय कौन-सी फ़िल्टर वैल्यू मान्य हैं।
- प्लेटफ़ॉर्म
- Amazon
- मुख्य endpoint
- /amazon-search-deals-v2
- हर कॉल पर quota
- 1 रिक्वेस्ट
- फ़्री प्लान
- 100 रिक्वेस्ट / महीनाउसके बाद €30 / महीना से
Amazon डेटा, इस्तेमाल के लिए तैयार
डील्स रिस्पॉन्स में currentPage, lastPage, countDeals, domainCode और usedFilter होते हैं – usedFilter लागू की गई रिफ़ाइनमेंट स्थिति को दोहराता है, ताकि आप जाँच सकें कि आपके फ़िल्टर लागू हुए। deals डील कार्ड का array है: id और dealType (BEST_DEAL, LIGHTNING_DEAL …), title, url, asin, price, retailPrice, savingAmount, savingPercentage, currency, dealState (AVAILABLE, और डील आगे बढ़ने पर बाद की स्थितियाँ), badgeMessage ("Limited time deal"), productRating, countReview, imgUrls और brand, जहाँ Amazon उसे दिखाता है।
GET /amz/amazon-deal-filter-v2 किसी मार्केटप्लेस की लाइव फ़िल्टर शब्दावली लौटाता है: label/value जोड़ों के रूप में departments ("Appliances" → 2619526011), discountRange के स्टेप ("10% off or more" → 1), minProductStarRating, priceRange बैंड, Prime Exclusive और Prime Early Access के लिए accessType, brands और Lightning deals जैसे सक्रिय collections। इन वैल्यू को हार्ड-कोड करने के बजाय deals endpoint में डालें – डिपार्टमेंट ID और बैंड हर मार्केटप्लेस में अलग होते हैं।
- डील कीमत, लिस्ट प्राइस, savingAmount और savingPercentage नंबर के रूप में, मुद्रा के साथ
- Lightning Deals को चालू Best Deals से अलग पहचानने के लिए dealType, dealState और badgeMessage
- हर डील कार्ड के लिए ASIN, प्रोडक्ट URL, इमेज, रेटिंग, रिव्यू संख्या और ब्रांड
- फ़िल्टर: departments, discountRange (1–5), minProductStarRating (1–4), priceRange (1–5), primeEarly, primeExclusive
- हर मार्केटप्लेस के मान्य डिपार्टमेंट ID, बैंड और सक्रिय collections के साथ फ़िल्टर-डिस्कवरी endpoint
- हर पेज पर 30 डील्स, Amazon के अपने ग्रिड की तरह
- domainCode से हर मार्केटप्लेस – com, de, co.uk, fr, it, es, ca, co.jp और भी
टीमें इससे क्या बनाती हैं
डील एग्रीगेटर और अलर्ट सेवाएँ
Prime Day या Black Friday पर हर कुछ मिनट में डील्स ग्रिड पोल करें, savingPercentage और productRating पर फ़िल्टर करें, और नई Lightning Deals बिकने से पहले सब्सक्राइबर तक पहुँचाएँ।
प्रतिस्पर्धी प्रमोशन मॉनिटरिंग
ब्रांड देखते हैं कि उनके डिपार्टमेंट में कौन-से प्रतिस्पर्धी डील्स चलाते हैं, छूट कितनी गहरी है और कोई डील कितने समय तक AVAILABLE रहती है – यह उनके अपने प्रोमो कैलेंडर के लिए इनपुट है।
एफ़िलिएट कंटेंट
priceRange और departments फ़िल्टर से रोज़ "best deals under 25 in Electronics" जैसे पेज बनाएँ, और हर ASIN को अपने टैग के साथ लिंक करें।
कीमत में गड़बड़ी की रिसर्च
retailPrice को price-history endpoint के साथ सेव करें, ताकि जाँच सकें कि डील की रेफ़रेंस कीमतें असल हाल की कीमतों को दर्शाती हैं या नहीं।
उदाहरण रिक्वेस्ट और रिस्पॉन्स
GET /amz/amazon-search-deals-v2 को domainCode और page के साथ कॉल करें। फ़िल्टर endpoint से एक या ज़्यादा ID के साथ departments जोड़ें (कॉमा से अलग), discountRange, minProductStarRating, priceRange एक अंक के रूप में, और primeEarly या primeExclusive boolean के रूप में। उदाहरण Appliances डिपार्टमेंट में कम से कम 25 % छूट और न्यूनतम 4 स्टार वाली डील्स माँगता है।
GET /amz/amazon-search-deals-v2
curl "https://api.everydata.io/amz/amazon-search-deals-v2?domainCode=com&page=1&departments=2619526011&discountRange=2&minProductStarRating=4" \
-H "x-api-key: YOUR_API_KEY"रिस्पॉन्स (संक्षिप्त)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"currentPage": 1,
"lastPage": 2,
"countDeals": 30,
"domainCode": "com",
"usedFilter": {
"state": {
"refinementFilters": {
"departments": [
"2619526011"
],
"reviewRating": [
"4"
],
"percentOff": [
"2"
]
}
},
"version": 1
},
"deals": [
{
"id": "35911091",
"dealType": "BEST_DEAL",
"title": "Ultra Pain Relief Cooling Pillow for Neck Support, Adjustable Cervical Pillow, Odorless Ergonomic Contour Memory Foam",
"url": "https://www.amazon.com/Adjustable-Cervical-Sleeping-Ergonomic-Orthopedic/dp/B0C1GQ54QD",
"price": 31.32,
"retailPrice": 52.22,
"savingAmount": 20.9,
"savingPercentage": 40,
"asin": "B0C1GQ54QD",
"badgeMessage": "Limited time deal",
"productRating": "4.2",
"countReview": 23511,
"currency": "USD",
"dealState": "AVAILABLE"
}
]
}पेजिंग डील्स ग्रिड के बिल्कुल अनुरूप है: हर पेज पर 30 कार्ड। lastPage वह है जो फ़ेच के समय Amazon के पेजिनेशन ने दिखाया, लेकिन डील्स पेज लगातार बदलता रहता है – डील्स बिक जाती हैं, नई Lightning Deals शुरू होती हैं – इसलिए सुरक्षित लूप यह है कि lastPage पर रुकने के बजाय page तब तक बढ़ाएँ जब तक deals array ख़ाली न लौटे। id या asin से डुप्लिकेट हटाएँ, क्योंकि दो कॉल के बीच कोई कार्ड page 2 से page 1 पर खिसक सकता है।
हर कार्ड में हर फ़ील्ड नहीं होता। जिन कार्ड को Amazon बिना डील बैज के रेंडर करता है – अक्सर ग्रिड के अंत में "related" प्रोडक्ट – वे price, retailPrice या dealType के बिना आते हैं। savingPercentage को आधिकारिक छूट और retailPrice को Amazon की रेफ़रेंस कीमत मानें, जो मार्केटप्लेस के हिसाब से लिस्ट प्राइस या हाल की सामान्य कीमत हो सकती है।
डील कार्ड पर productRating "4.2" जैसी सादी स्ट्रिंग होती है, प्रोडक्ट पेज के "4.2 out of 5 stars" रूप से अलग। किसी मार्केटप्लेस में मौजूद न होने वाला डिपार्टमेंट ID ख़ाली deals array लौटाता है और आपका फ़िल्टर usedFilter में दोहराया जाता है।
संबंधित endpoints
डील्स. किसी मार्केटप्लेस की आज की डील्स, हर पेज पर 30, डिपार्टमेंट, छूट, कीमत और रेटिंग फ़िल्टर के साथ।
डील फ़िल्टर. deals endpoint के लिए मान्य फ़िल्टर वैल्यू (डिपार्टमेंट, छूट रेंज, प्राइस रेंज)।
ASIN से प्रोडक्ट विवरण. प्रोडक्ट विवरण जैसा ही payload, ASIN और मार्केटप्लेस से।
मूल्य इतिहास. इस API द्वारा जुटाई गई ऐतिहासिक कीमतें।
प्रति रिक्वेस्ट भुगतान, सभी प्लेटफ़ॉर्म शामिल
हर डील्स पेज और हर फ़िल्टर लुकअप एक रिक्वेस्ट है; फ़िल्टर शब्दावली कम ही बदलती है, इसलिए इसे हर मार्केटप्लेस के लिए दिन में एक बार फ़ेच करें। पाँच डिपार्टमेंट को दो पेजों पर हर दस मिनट में पोल करने वाला ट्रैकर हर महीने लगभग 43,000 रिक्वेस्ट इस्तेमाल करता है – Production प्लान (50,000 रिक्वेस्ट, €80) इसे कवर करता है; अगर इवेंट वाले दिनों का उछाल आपको मासिक quota से आगे ले जाए, तो कभी भी अपग्रेड करें (prorated)। upstream 5xx रिस्पॉन्स का कभी शुल्क नहीं लगता।
- Free
- 100 रिक्वेस्ट / महीना
- Starter
- 5,000 रिक्वेस्ट · €30
- Production
- 50,000 रिक्वेस्ट · €80
- Business
- 3,00,000 रिक्वेस्ट · €300
Amazon Deals API: अक्सर पूछे जाने वाले सवाल
मुझे मान्य डिपार्टमेंट ID कैसे मिलेंगे?
GET /amz/amazon-deal-filter-v2 को domainCode के साथ कॉल करें। departments "Appliances" → 2619526011 जैसे label/value जोड़े दिखाता है; value को deals endpoint में भेजें। ID मार्केटप्लेस के बीच अलग होते हैं, इसलिए हर domainCode के लिए उन्हें देखें।
discountRange और priceRange की वैल्यू का क्या मतलब है?
ये Amazon के दिए बैंड की क्रम-संख्या हैं – जैसे discountRange 1 का मतलब "10% off or more" और 2 का "25% off or more"; priceRange 1 का मतलब "Under 25"। फ़िल्टर endpoint हर वैल्यू के मौजूदा लेबल लौटाता है।
lastPage 4 बताने के बावजूद page 3 ख़ाली array क्यों लौटाता है?
डील्स ख़त्म होने और शुरू होने के साथ डील्स ग्रिड लगातार बदलता रहता है, इसलिए आपकी पहली कॉल पर मिली पेज संख्या एक मिनट बाद सही न रहे, ऐसा हो सकता है। deals array ख़ाली होने तक लूप चलाएँ और id से डुप्लिकेट हटाएँ।
क्या मैं सिर्फ़ Lightning Deals माँग सकता हूँ?
किसी अलग पैरामीटर से नहीं, लेकिन हर कार्ड में dealType और badgeMessage होते हैं, इसलिए LIGHTNING_DEAL के लिए client-side फ़िल्टर करें। फ़िल्टर endpoint का collections फ़ील्ड दिखाता है कि इस समय कोई Lightning-deals collection सक्रिय है या नहीं।
क्या API डील का countdown लौटाता है?
नहीं। dealState बताता है कि डील इस समय AVAILABLE है या नहीं, लेकिन countdown टाइमर और claimed-percentage बार शामिल नहीं हैं। स्टॉक ख़त्म होना जल्दी पकड़ने के लिए कम अंतराल पर पोल करें।
संबंधित उपयोग के उदाहरण
Amazon डील्स निकालना शुरू करें
फ़्री अकाउंट बनाएँ, अपने मार्केटप्लेस की फ़िल्टर शब्दावली फ़ेच करें और लाइव डील्स ग्रिड JSON में पढ़ें – हर महीने 100 रिक्वेस्ट शामिल।