शॉपिंग · Walmart
Walmart Search API
Walmart Search API से आपको लाइव Walmart डेटा ठीक उसी पल मिलता है जब आप पूछते हैं, साफ़ स्ट्रक्चर्ड रूप में – आपके ऐप, स्प्रेडशीट या AI असिस्टेंट के लिए तैयार। न स्क्रैपिंग, न रखरखाव।
हर महीने 100 फ़्री रिक्वेस्ट · क्रेडिट कार्ड की ज़रूरत नहीं · सभी प्लेटफ़ॉर्म के लिए एक API key
मुख्य तथ्य
अपडेट:
walmart.com में कोई कीवर्ड टाइप करने पर हर पेज पर 40 प्रोडक्ट तक का ग्रिड आता है, हर एक के साथ कीमत, कटी हुई was-price, स्टार रेटिंग, विक्रेता और स्टॉक बैज। everydata.io का Walmart Search API आपके लिए ठीक यही सर्च चलाता है – कोई भी कीवर्ड, कोई भी पेज, relevance, best sellers या कीमत से sort – और Walmart का रिज़ल्ट डेटा JSON में लौटाता है। किसी कैटेगरी के usItemId खोजने, किसी सर्च शब्द पर कौन रैंक करता है यह देखने, या एक क्वेरी पर मुक़ाबला कर रहे सभी विक्रेताओं की प्राइस तुलना बनाने का यह सबसे तेज़ तरीका है।
- प्लेटफ़ॉर्म
- Walmart
- मुख्य endpoint
- /walmart-search-by-keyword
- हर कॉल पर quota
- 1 रिक्वेस्ट
- फ़्री प्लान
- 100 रिक्वेस्ट / महीनाउसके बाद €30 / महीना से
Walmart डेटा, इस्तेमाल के लिए तैयार
रिस्पॉन्स का ऊपरी हिस्सा आपकी क्वेरी दोहराता है: keyword, sortStrategy और domainCode। रिज़ल्ट लिस्ट item.props.pageProps.initialData.searchResult के नीचे होती है, जहाँ aggregatedCount मैच की कुल संख्या देता है (उदाहरण में "Lego star wars" के लिए 3998) और itemStacks[0].items प्रोडक्ट ग्रिड है। __typename Product वाले हर आइटम में usItemId, name, canonicalUrl, image, नंबर के रूप में price और itemPrice, wasPrice, linePriceDisplay ("Now $15.99") व savingsAmt वाला priceInfo ब्लॉक होता है।
रैंकिंग का संदर्भ भी साथ आता है: flag "Popular pick" या "Best seller" जैसे Walmart के बैज चिह्नित करता है, rating.averageRating और numberOfReviews सामाजिक प्रमाण देते हैं, sellerName बताता है कि ऑफ़र Walmart.com के पास है या किसी मार्केटप्लेस विक्रेता के पास, और fulfillmentSpeed / fulfillmentType दिखाते हैं कि आइटम शिप होता है, आज स्टोर में है या सिर्फ़ पिकअप के लिए है। isOutOfStock और availabilityStatusDisplayValue से आप विस्तार से लुकअप करने से पहले अनुपलब्ध आइटम फ़िल्टर कर सकते हैं।
- हर रिज़ल्ट के लिए usItemId, name, canonicalUrl और image – id सीधे product और reviews endpoint में जाता है
- price (नंबर), साथ में priceInfo.itemPrice, wasPrice, savingsAmt और ख़रीदारों को दिखने वाली display स्ट्रिंग
- हर रिज़ल्ट के लिए rating.averageRating और numberOfReviews
- Walmart के अपने ऑफ़र को मार्केटप्लेस ऑफ़र से अलग करने के लिए sellerName और sellerId
- flag बैज ("Popular pick", "Best seller"), isOutOfStock, fulfillmentSpeed और fulfillmentType
- पूरी क्वेरी के लिए aggregatedCount और कई वेरिएंट वाले आइटम के लिए variantList
- sortBy से sorting: best_match (डिफ़ॉल्ट), best_seller, price_low, price_high
टीमें इससे क्या बनाती हैं
सर्च-रैंक ट्रैकिंग
ब्रांड हर दिन दर्ज करते हैं कि उनके टॉप कीवर्ड पर best_match और best_seller के तहत उनके आइटम कहाँ दिखते हैं, flag बैज और आसपास के प्रतिस्पर्धी विक्रेताओं के साथ।
असॉर्टमेंट की खोज
पूरी कैटेगरी – "cordless drill", "air fryer", "Lego star wars" – के usItemId पेज-दर-पेज इकट्ठा करें, फिर product और review लुकअप से शॉर्टलिस्ट समृद्ध करें।
प्राइस-सीढ़ी विश्लेषण
किसी क्वेरी के सबसे सस्ते और सबसे महँगे ऑफ़र और उस रेंज में अपने प्रोडक्ट की जगह देखने के लिए price_low और price_high से sort करें।
प्रतिस्पर्धी विक्रेता इंटेलिजेंस
रिज़ल्ट को sellerName के हिसाब से ग्रुप करें, ताकि देख सकें कि पहले पेज का कितना हिस्सा Walmart.com के पास है और कितना मार्केटप्लेस विक्रेताओं के पास, और कौन-से विक्रेता किसी niche पर हावी हैं।
उदाहरण रिक्वेस्ट और रिस्पॉन्स
GET /wlm/walmart-search-by-keyword को keyword और page के साथ कॉल करें – दोनों ज़रूरी हैं, इसलिए page=1 से शुरू करें और बढ़ाते जाएँ। Walmart के Best Sellers क्रम के लिए sortBy=best_seller जोड़ें, या प्राइस सीढ़ी के लिए price_low / price_high। उदाहरण एक प्रोडक्ट आइटम तक छोटा किया गया है; असली पेज में 40 आइटम तक होते हैं, और sponsored टाइलें व विज्ञापन मॉड्यूल दूसरे __typename वैल्यू के साथ आते हैं।
GET /wlm/walmart-search-by-keyword
curl "https://api.everydata.io/wlm/walmart-search-by-keyword?keyword=Lego+star+wars&page=1&sortBy=best_seller" \
-H "x-api-key: YOUR_API_KEY"रिस्पॉन्स (संक्षिप्त)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"sortStrategy": "best_seller",
"domainCode": "com",
"keyword": "Lego star wars",
"item": {
"page": "/search",
"query": {
"q": "Lego star wars",
"page": "1",
"sort": "best_seller"
},
"props": {
"pageProps": {
"initialData": {
"searchResult": {
"title": "Results for \"Lego star wars\"",
"aggregatedCount": 3998,
"itemStacks": [
{
"count": 3998,
"items": [
{
"__typename": "Product",
"usItemId": "1520961263",
"name": "LEGO Star Wars 501st Clone Troopers Battle Pack Set 75345",
"canonicalUrl": "/ip/LEGO-Star-Wars-501st-Clone-Troopers-Battle-Pack-Set-75345/1520961263",
"image": "https://i5.walmartimages.com/seo/LEGO-Star-Wars-501st-Clone-Troopers-Battle-Pack-Set-75345.jpeg",
"price": 15,
"priceInfo": {
"itemPrice": "$19.97",
"linePrice": "$15.99",
"wasPrice": "$19.97",
"linePriceDisplay": "Now $15.99",
"savingsAmt": 3.98,
"savings": "SAVE $3.98"
},
"rating": {
"averageRating": 4,
"numberOfReviews": 287
},
"flag": "Popular pick",
"availabilityStatusDisplayValue": "In stock",
"isOutOfStock": false,
"fulfillmentSpeed": [
"TODAY"
],
"fulfillmentType": "STORE",
"sellerName": "Walmart.com",
"numberOfReviews": 287
}
]
}
]
}
}
}
}
}
}मैपिंग से पहले आइटम को __typename === "Product" पर फ़िल्टर करें। ग्रिड में विज्ञापन, ब्रांड बैनर और "related search" टाइलों के मॉड्यूल भी होते हैं, जो उसी array में होते हैं पर उनमें usItemId नहीं होता। फ़िल्टर किए गए array में पोज़िशन वही ऑर्गेनिक रैंक है जो आपको उस sort क्रम और स्टोर संदर्भ के लिए पेज पर दिखेगी।
पेजिंग स्पष्ट है: वही keyword और sortBy रखें, page एक-एक करके बढ़ाएँ, और जब aggregatedCount पूरा हो जाए या items array ख़ाली लौटे तो रुक जाएँ। Walmart सीमित करता है कि सर्च कितनी गहराई तक जाए, इसलिए बहुत व्यापक कीवर्ड सभी 3,998 मैच नहीं लौटाएँगे – असॉर्टमेंट का ज़्यादा हिस्सा कवर करने के लिए कीवर्ड सीमित करें या sort क्रम के हिसाब से बाँटें।
सर्च रिज़ल्ट की कीमतें डिफ़ॉल्ट लोकेशन के स्टोर संदर्भ वाली कीमतें हैं और कीमत बदलने के बाद प्रोडक्ट पेज से कुछ सेंट अलग हो सकती हैं। जब कोई रिज़ल्ट व्यावसायिक रूप से मायने रखे, तो पहले से मौजूद canonicalUrl के साथ /wlm/walmart-lookup-product से उसकी पुष्टि करें।
संबंधित endpoints
प्रोडक्ट सर्च करें. पेजिंग और sorting के साथ कीवर्ड सर्च।
प्रोडक्ट विवरण. URL से प्रोडक्ट पेज।
रिव्यू. किसी प्रोडक्ट के पेजिंग वाले ग्राहक रिव्यू।
प्रति रिक्वेस्ट भुगतान, सभी प्लेटफ़ॉर्म शामिल
हर सर्च पेज एक रिक्वेस्ट है, चाहे वह 40 प्रोडक्ट लौटाए या 3। 50 कीवर्ड को पहले तीन पेजों पर रोज़ ट्रैक करना दिन में 150 रिक्वेस्ट है, हर महीने लगभग 4,500 – Starter प्लान (5,000 रिक्वेस्ट, €30) के भीतर। बड़े कीवर्ड सेट Production (50,000 रिक्वेस्ट, €80) या Business (300,000, €300) में आते हैं। upstream की विफल रिक्वेस्ट कभी नहीं गिनी जातीं।
- Free
- 100 रिक्वेस्ट / महीना
- Starter
- 5,000 रिक्वेस्ट · €30
- Production
- 50,000 रिक्वेस्ट · €80
- Business
- 3,00,000 रिक्वेस्ट · €300
Walmart Search API: अक्सर पूछे जाने वाले सवाल
एक पेज में कितने रिज़ल्ट होते हैं?
Walmart हर पेज पर 40 प्रोडक्ट टाइलें तक दिखाता है। ग्रिड में विज्ञापन प्लेसमेंट और मॉड्यूल के साथ सटीक संख्या बदलती है, इसलिए हमेशा __typename Product पर फ़िल्टर करें।
कौन-से sort विकल्प उपलब्ध हैं?
sortBy best_match (डिफ़ॉल्ट), best_seller, price_low और price_high स्वीकार करता है। रिस्पॉन्स sortStrategy में लागू वैल्यू दोहराता है।
क्या page सच में ज़रूरी है?
हाँ, keyword और page दोनों अनिवार्य हैं। page=1 से शुरू करें और ऊपर की ओर पेजिनेट करें; कोई cursor नहीं है।
क्या मैं walmart.ca पर सर्च कर सकता हूँ?
कीवर्ड सर्च फ़िलहाल walmart.com पर चलती है और domainCode com लौटाती है। कनाडा का कवरेज domainCode=ca के ज़रिए रिव्यू के लिए है।
क्या रिज़ल्ट में sponsored प्रोडक्ट शामिल होते हैं?
रिज़ल्ट डेटा में वही होता है जो पेज रेंडर करता है, sponsored टाइलों सहित। sponsored एंट्री आइटम के अपने flags और मॉड्यूल में दिखती हैं, ताकि आप उन्हें ऑर्गेनिक-रैंक की गणना से हटा सकें।
संबंधित उपयोग के उदाहरण
अपनी पहली Walmart सर्च चलाएँ
फ़्री अकाउंट बनाएँ और किसी भी कीवर्ड के साथ search endpoint कॉल करें – हर महीने 100 रिक्वेस्ट शामिल, क्रेडिट कार्ड नहीं।