शॉपिंग · Amazon
Amazon Search Results API
Amazon Search Results API से आपको लाइव Amazon डेटा ठीक उसी पल मिलता है जब आप पूछते हैं, साफ़ स्ट्रक्चर्ड रूप में – आपके ऐप, स्प्रेडशीट या AI असिस्टेंट के लिए तैयार। न स्क्रैपिंग, न रखरखाव।
हर महीने 100 फ़्री रिक्वेस्ट · क्रेडिट कार्ड की ज़रूरत नहीं · सभी प्लेटफ़ॉर्म के लिए एक API key
मुख्य तथ्य
अपडेट:
Amazon का सर्च पेज मार्केटप्लेस की दुकान की खिड़की है: किसी क्वेरी पर कौन-से ASIN रैंक करते हैं, उनमें से कौन-से पेड प्लेसमेंट हैं, उनकी कीमत क्या है और पिछले महीने कितने लोगों ने उन्हें ख़रीदा। everydata.io का Amazon Search Results API किसी भी कीवर्ड और मार्केटप्लेस के लिए यह पेज लाइव फ़ेच करता है और रिज़ल्ट ग्रिड को JSON array के रूप में लौटाता है – हर रिज़ल्ट पेज के लिए एक कॉल, ठीक वैसे ही sort किया जा सकता है जैसे कोई ख़रीदार करता है, और sponsored प्रोडक्ट या तो चिह्नित होते हैं या हटा दिए जाते हैं।
- प्लेटफ़ॉर्म
- Amazon
- मुख्य endpoint
- /amazon-search-by-keyword-asin
- हर कॉल पर quota
- 1 रिक्वेस्ट
- फ़्री प्लान
- 100 रिक्वेस्ट / महीनाउसके बाद €30 / महीना से
Amazon डेटा, इस्तेमाल के लिए तैयार
हर कॉल ठीक एक रिज़ल्ट पेज के प्रोडक्ट रैंकिंग क्रम में लौटाती है। numberOfProducts बताता है कि उस पेज पर कितने ऑर्गेनिक प्रोडक्ट थे, numberOfSponsoredProducts कि बीच में कितने विज्ञापन थे, और resultCount उस कीवर्ड के लिए Amazon का अपना "over 100,000 results" आँकड़ा है। foundProducts और foundSponsoredProducts सीधी ASIN लिस्ट हैं, जो डिटेल ऑब्जेक्ट छुए बिना तुरंत रैंक चेक करने के काम आती हैं।
searchProductDetails में हर टाइल का विवरण होता है: productDescription (टाइल का टाइटल), asin, नंबर के रूप में price और retailPrice और साथ में currency, productRating और countReview, prime बैज, salesVolume ("50+ bought in past month"), Amazon का दिखाया deliveryMessage और एक sponsored फ़्लैग। dpUrl प्रोडक्ट का रिलेटिव लिंक है, ताकि आप मार्केटप्लेस होस्ट के साथ canonical URL बना सकें। starFilterParam और categories वे रिफ़ाइनमेंट दिखाते हैं जो Amazon ने रिज़ल्ट के साथ दिए।
- हर पेज की रैंक की गई रिज़ल्ट लिस्ट, ऑर्गेनिक और sponsored गिनती अलग-अलग
- हर टाइल के लिए ASIN, टाइटल, कीमत, लिस्ट प्राइस, मुद्रा, रेटिंग, रिव्यू संख्या और इमेज URL
- हर प्रोडक्ट के लिए Prime पात्रता, sales-volume बैज और Amazon का डिलीवरी मैसेज
- sortBy: relevanceblender, price-asc-rank, price-desc-rank, review-rank, date-desc-rank
- क्वेरी को किसी search alias (category) या browse node id (browseNode) तक सीमित करें
- विज्ञापन हटाने के लिए excludeSponsored=true; 10 मिनट पुराना cache किया गया पेज स्वीकार करने के लिए withCache=true
- domainCode से हर मार्केटप्लेस – com, de, co.uk, fr, it, es, ca, co.jp, in, com.au, nl, se, pl और भी
टीमें इससे क्या बनाती हैं
विक्रेताओं और एजेंसियों के लिए कीवर्ड रैंक ट्रैकिंग
हर ट्रैक किए गए कीवर्ड के लिए रोज़ एक बार पेज 1–3 फ़ेच करें, foundProducts में अपने ASIN खोजें और पोज़िशन सेव करें। sponsored फ़्लैग से ऑर्गेनिक और sponsored रैंक अलग करें।
Share-of-shelf और प्रतिस्पर्धी मॉनिटरिंग
amazon.com, .de और .co.uk पर अपनी मुख्य क्वेरी के लिए गिनें कि पहले पेज की कितनी टाइलें किस ब्रांड की हैं। salesVolume हर प्रतिस्पर्धी के लिए माँग का संकेत जोड़ता है।
प्रोडक्ट डिस्कवरी और सोर्सिंग
किसी niche में अच्छी रेटिंग वाले या नए लिस्ट हुए प्रोडक्ट सामने लाने के लिए review-rank या date-desc-rank से sort करें, फिर शॉर्टलिस्ट का विवरण प्रोडक्ट endpoint से निकालें।
Ad-intelligence डैशबोर्ड
हर पेज का numberOfSponsoredProducts और sponsored ASIN लिस्ट दिखाते हैं कि किसी कीवर्ड पर कितनी होड़ है और कौन-से प्रतिस्पर्धी उसके लिए प्लेसमेंट ख़रीदते हैं।
उदाहरण रिक्वेस्ट और रिस्पॉन्स
GET /amz/amazon-search-by-keyword-asin को keyword और domainCode के साथ कॉल करें। page डिफ़ॉल्ट रूप से 1 है और 400 तक जाता है; sortBy डिफ़ॉल्ट रूप से relevanceblender है, जो Amazon का "Featured" क्रम है। category पैरामीटर search alias ठीक वैसे ही लेता है जैसे Amazon उसे डिपार्टमेंट ड्रॉपडाउन में इस्तेमाल करता है – सभी डिपार्टमेंट के लिए aps, electronics, computers आदि। ग़लत alias से ख़ाली रिज़ल्ट मिलता है, एरर नहीं, इसलिए हर मार्केटप्लेस के लिए ज्ञात aliases की एक लिस्ट रखें।
GET /amz/amazon-search-by-keyword-asin
curl "https://api.everydata.io/amz/amazon-search-by-keyword-asin?keyword=laptop&domainCode=com&page=1&sortBy=relevanceblender&excludeSponsored=false" \
-H "x-api-key: YOUR_API_KEY"रिस्पॉन्स (संक्षिप्त)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"sortStrategy": "relevanceblender",
"domainCode": "com",
"keyword": "laptop",
"numberOfProducts": 26,
"numberOfSponsoredProducts": 6,
"resultCount": 100000,
"selectedCategory": "aps",
"foundSponsoredProducts": [
"B0FGJ14KRX",
"B0GY7F4FDK"
],
"foundProducts": [
"B0HFJ9BNPL",
"B0HF38QXHL"
],
"searchProductDetails": [
{
"productDescription": "Acer Aspire 14 AI Copilot+ PC - Intel Core Ultra 5 226V & 14” WUXGA Touch | 16GB LPDDR5X | 1TB Gen 4 SSD",
"asin": "B0FGJ14KRX",
"countReview": 20,
"imgUrl": "https://m.media-amazon.com/images/I/61kp09SeFyL._AC_UY218_.jpg",
"price": 548.44,
"retailPrice": 0,
"productRating": "4.0 out of 5 stars",
"prime": false,
"dpUrl": "/dp/B0FGJ14KRX",
"salesVolume": "50+ bought in past month",
"sponsored": true,
"currency": "USD"
}
],
"starFilterParam": {
"Apply 4 Stars & Up filter to narrow results": "p_72:1248879011"
},
"currentPage": 1,
"lastPage": 20
}पेजिंग स्पष्ट है: currentPage वही लौटाता है जो आपने माँगा था और lastPage वह सबसे ऊँचा पेज है जिसे Amazon ने अपने पेजिनेशन बार में लिंक किया। लेआउट के हिसाब से एक आम पेज में 16 से 60 टाइल होती हैं, इसलिए numberOfProducts बदलता रहता है। रैंक पोज़िशन searchProductDetails का array index और पिछले पेजों का offset है – API टाइलों को दोबारा नंबर नहीं देता, इसलिए sponsored एंट्री अपनी असली जगह पर रहती हैं, जब तक आप excludeSponsored=true न भेजें।
रिज़ल्ट मार्केटप्लेस पर और उस रिक्वेस्ट के लिए Amazon की डिफ़ॉल्ट डिलीवरी लोकेशन पर निर्भर करते हैं; उदाहरण का deliveryMessage ("Ships to Germany") दिखाता है कि कौन-सी लोकेशन लागू हुई। retailPrice 0 का मतलब है कि कोई कटी हुई लिस्ट प्राइस नहीं दिखाई गई, और price 0 का मतलब है कि टाइल पर कोई कीमत ही नहीं थी – ऐसा उन आइटम के साथ होता है जिनके वेरिएशन में पहले चयन करना पड़ता है।
10 मिनट का cache (withCache=true) तब काम आता है जब आपके सिस्टम के कई हिस्से कुछ ही मिनटों में एक ही क्वेरी भेजते हैं – दूसरी कॉल का जवाब cache से मिलता है और तेज़ आता है। जब alias बहुत व्यापक हो, तो browseNode क्वेरी को 10158976011 जैसे node id तक सीमित कर देता है।
संबंधित endpoints
प्रोडक्ट सर्च करें. पेजिंग, sorting और sponsored फ़िल्टरिंग के साथ कीवर्ड सर्च।
ASIN से प्रोडक्ट विवरण. प्रोडक्ट विवरण जैसा ही payload, ASIN और मार्केटप्लेस से।
बेस्ट सेलर्स. किसी कैटेगरी URL की बेस्ट सेलर्स लिस्ट।
प्रति रिक्वेस्ट भुगतान, सभी प्लेटफ़ॉर्म शामिल
एक रिज़ल्ट पेज एक रिक्वेस्ट के बराबर है, पेज का साइज़ चाहे जो हो। 100 कीवर्ड को पहले तीन पेजों पर रोज़ ट्रैक करने में हर महीने लगभग 9,000 रिक्वेस्ट लगती हैं – Production प्लान (50,000 रिक्वेस्ट, €80) इसे कई मार्केटप्लेस की गुंजाइश के साथ कवर करता है, और Starter (5,000 रिक्वेस्ट, €30) सिर्फ़ पेज 1 पर छोटे कीवर्ड सेट के लिए ठीक है। Amazon की ओर की 5xx विफलताओं का शुल्क नहीं लगता।
- Free
- 100 रिक्वेस्ट / महीना
- Starter
- 5,000 रिक्वेस्ट · €30
- Production
- 50,000 रिक्वेस्ट · €80
- Business
- 3,00,000 रिक्वेस्ट · €300
स्टेप-बाय-स्टेप बनाएँ
Amazon Search Results API: अक्सर पूछे जाने वाले सवाल
हर पेज पर कितने प्रोडक्ट लौटाए जाते हैं?
ठीक उतने जितने Amazon ने उस पेज पर रेंडर किए – आमतौर पर 16 से 60 टाइल, जो numberOfProducts और numberOfSponsoredProducts में बताई जाती हैं। तय संख्या में रिज़ल्ट के लिए तब तक पेज माँगते रहें जब तक पर्याप्त न हो जाएँ या currentPage, lastPage तक न पहुँच जाए।
क्या मैं रिज़ल्ट को कीमत या रेटिंग से फ़िल्टर कर सकता हूँ?
सीधे पैरामीटर के रूप में नहीं। कीमत या रिव्यू के हिसाब से क्रम के लिए sortBy इस्तेमाल करें, फिर price और productRating पर client-side फ़िल्टर करें। starFilterParam फ़ील्ड वह रिफ़ाइनमेंट दिखाता है जो Amazon ने दिया, जिसे आप जहाँ लागू हो वहाँ browseNode जैसी सीमा के रूप में दोबारा इस्तेमाल कर सकते हैं।
क्या sponsored प्रोडक्ट शामिल होते हैं?
डिफ़ॉल्ट रूप से हाँ, हर एक sponsored: true से चिह्नित होता है और foundSponsoredProducts में अलग से लिस्ट होता है। सिर्फ़ ऑर्गेनिक रिज़ल्ट पाने के लिए excludeSponsored=true सेट करें।
क्या सर्च EAN या UPC कोड के लिए काम करती है?
हाँ – Amazon GTIN को कीवर्ड की तरह लेता है और आमतौर पर मैच करने वाला ASIN पहले रिज़ल्ट के रूप में लौटाता है। प्रोडक्ट endpoint कॉल करने से पहले बारकोड को ASIN में बदलने का यही मानक तरीका है।
मैं किन मार्केटप्लेस पर सर्च कर सकता हूँ?
domainCode के ज़रिए सभी Amazon मार्केटप्लेस, com और de से लेकर co.jp, com.au, pl, ae और sg तक। टाइटल और डिलीवरी मैसेज मार्केटप्लेस की भाषा में आते हैं।
संबंधित उपयोग के उदाहरण
अपनी पहली Amazon सर्च क्वेरी चलाएँ
फ़्री में साइन अप करें, एक कीवर्ड भेजें और पूरा रिज़ल्ट पेज JSON में पाएँ – हर महीने 100 रिक्वेस्ट बिना किसी शुल्क के।