शॉपिंग · Otto
Otto Search API
Otto Search API से आपको लाइव Otto डेटा ठीक उसी पल मिलता है जब आप पूछते हैं, साफ़ स्ट्रक्चर्ड रूप में – आपके ऐप, स्प्रेडशीट या AI असिस्टेंट के लिए तैयार। न स्क्रैपिंग, न रखरखाव।
हर महीने 100 फ़्री रिक्वेस्ट · क्रेडिट कार्ड की ज़रूरत नहीं · सभी प्लेटफ़ॉर्म के लिए एक API key
मुख्य तथ्य
अपडेट:
otto.de पर "Highboard" की कीवर्ड सर्च दो सौ से ज़्यादा पेजों में फैले कई हज़ार प्रोडक्ट लौटाती है, जिनमें sponsored प्लेसमेंट मिले होते हैं और रैंकिंग इस पर निर्भर करती है कि ख़रीदार bestsellers, कीमत या नएपन से sort करता है। everydata.io का Otto Search API ये रिज़ल्ट पेज स्ट्रक्चर्ड JSON में देता है – हर पेज के लिए एक कॉल, आपके चुने sort क्रम के साथ – ताकि आप स्टोरफ़्रंट रेंडर किए बिना रैंकिंग ट्रैक कर सकें, नई लिस्टिंग खोज सकें या कैटेगरी-स्तर के प्राइस आँकड़े बना सकें।
- प्लेटफ़ॉर्म
- Otto
- मुख्य endpoint
- /otto-search-by-keyword
- हर कॉल पर quota
- 2 रिक्वेस्ट
- फ़्री प्लान
- 100 रिक्वेस्ट / महीनाउसके बाद €30 / महीना से
Otto Search API क्या लौटाता है
हर रिस्पॉन्स सर्च मेटाडेटा से शुरू होता है: keyword और sortStrategy आपकी रिक्वेस्ट दोहराते हैं, resultCount otto.de द्वारा बताई गई कुल हिट संख्या है, numberOfProducts बताता है कि इस पेज पर कितने आइटम हैं, और nextPage / lastPage आपका पेजिनेशन लूप चलाते हैं। उदाहरण के लिए Highboard सर्च पेज एक पर 120 प्रोडक्ट लौटाती है, कुल 56 पेजों में 5,166 में से।
searchProductDetails रिज़ल्ट लिस्ट है। हर एंट्री में productDescription (लिस्टिंग टाइटल), manufacturer, productId और टाइल के लिए Otto का चुना variationId, EUR में price और retailPrice, productRating और countReview, imgUrl, dpUrl (?variationId= सहित रिलेटिव प्रोडक्ट path), "lieferbar - in 2-3 Werktagen bei dir" जैसा deliveryMessage, एक sponsored boolean और sibling variationId व उनके लेबल वाला variations array होता है, जैसे "Weiß | Korpus: Weiß"।
- निश्चित पेजिंग के लिए keyword, sortStrategy, resultCount, numberOfProducts, nextPage और lastPage
- हर प्रोडक्ट पर: productDescription, manufacturer, productId, variationId, dpUrl और imgUrl
- price और retailPrice नंबर के रूप में, ताकि रिज़ल्ट पेज पर छूट बस एक घटाव की दूरी पर हो
- अच्छे रिव्यू वाले आइटम फ़िल्टर करने के लिए productRating और countReview
- ऑर्गेनिक रिज़ल्ट को पेड प्लेसमेंट से अलग करने के लिए deliveryMessage और sponsored
- टाइल पर Otto के दिखाए हर रंग या साइज़ के लिए variationId और value के साथ variations[]
- sortBy: topseller (डिफ़ॉल्ट), preis-aufsteigend, preis-absteigend, neuheiten, bewertung
टीमें Otto Search API से क्या बनाती हैं
कीवर्ड रैंक ट्रैकिंग
हर सुबह sortBy=topseller के साथ अपने टॉप शब्दों पर अपने productId की पोज़िशन दर्ज करें, sponsored और ऑर्गेनिक स्लॉट अलग करें, और कोई प्रतिस्पर्धी आपसे ऊपर जाए तो अलर्ट भेजें।
नई लिस्टिंग की खोज
किसी कैटेगरी शब्द को sortBy=neuheiten के साथ पोल करें और productId की तुलना कल के सेट से करें, ताकि नए आर्टिकल, नए ब्रांड या नए रंग वेरिएशन कुछ ही घंटों में पकड़ सकें।
प्राइस-बैंड विश्लेषण
किसी प्रोडक्ट टाइप के सबसे सस्ते और सबसे महँगे ऑफ़र खोजने के लिए preis-aufsteigend और preis-absteigend के साथ सर्च पर चलें, फिर price और retailPrice से मीडियन कीमत और छूट की गहराई निकालें।
Sponsored-प्लेसमेंट ऑडिट
एजेंसियाँ हर पेज और कीवर्ड पर sponsored टाइलें गिनती हैं, ताकि माप सकें कि Otto किसी शब्द के लिए कितनी पेड इन्वेंटरी बेचता है और कौन-से ब्रांड उसे ख़रीदते हैं।
प्रोडक्ट क्रॉल की सीडिंग
पूरी कैटेगरी के dpUrl इकट्ठा करने के लिए सर्च को एंट्री पॉइंट की तरह इस्तेमाल करें, फिर स्पेसिफ़िकेशन, इमेज और पूरे वेरिएशन मैट्रिक्स के लिए उन्हें product endpoint को दें।
Otto Search API: उदाहरण रिक्वेस्ट और रिस्पॉन्स
GET /ott/otto-search-by-keyword को keyword और page के साथ कॉल करें; दोनों ज़रूरी हैं। किसी ख़रीदार का sort क्रम दोहराने के लिए sortBy जोड़ें – वैल्यू Otto की अपनी जर्मन sort keys हैं। डिफ़ॉल्ट topseller क्रम वाला पेज एक वही है जो कोई विज़िटर otto.de सर्च बॉक्स में शब्द टाइप करने के बाद देखता है।
GET /ott/otto-search-by-keyword
curl "https://api.everydata.io/ott/otto-search-by-keyword?keyword=highboard&page=1&sortBy=topseller" \
-H "x-api-key: YOUR_API_KEY"रिस्पॉन्स (संक्षिप्त)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"sortStrategy": "topseller",
"domainCode": "de",
"keyword": "highboard",
"numberOfProducts": 120,
"resultCount": 5166,
"nextPage": 2,
"lastPage": 56,
"searchProductDetails": [
{
"productDescription": "LeGer Home by Lena Gercke Highboard Essentials, Sideboard, Kommode, Anrichte, Schrank, Stauraumschrank, Breite: 111 cm, UV lackiert, Push-to-open-Funktion",
"manufacturer": "LeGer Home by Lena Gercke",
"productId": "1658198337",
"variationId": "2081559634",
"countReview": 1,
"imgUrl": "https://i.otto.de/i/otto/5ce00b97-95ba-5927-9915-35aaa2278456?$responsive_ft2$",
"price": 869.99,
"retailPrice": 1109.99,
"productRating": "1.0",
"dpUrl": "/p/leger-home-by-lena-gercke-highboard-essentials-sideboard-kommode-anrichte-schrank-stauraumschrank-breite-111-cm-uv-lackiert-push-to-open-funktion-1658198337/?variationId=2081559634",
"deliveryMessage": "lieferbar - in 2-3 Werktagen bei dir",
"sponsored": true,
"variations": [
{
"variationId": "2081559598",
"value": "Weiß | Korpus: Weiß"
},
{
"variationId": "2081559615",
"value": "Kaschmir | Korpus: Kaschmir"
}
]
}
]
}
dpUrl रिलेटिव है – इसके आगे https://www.otto.de लगाएँ, तो आपको ऐसा URL मिलता है जिसे आप सीधे GET /ott/otto-lookup-product में भेज सकते हैं। query string का variationId वह आइटम है जिसे Otto ने टाइल पर दिखाया; किसी sibling रंग को खोलने के लिए इसे variations[] के किसी id से बदलें। गहरी पेजिनेशन काम करती है, लेकिन कई हज़ार के resultCount में शायद ही सभी पेजों की ज़रूरत पड़ती है: रैंकिंग के काम के लिए पहले तीन पेज वह कवर करते हैं जिसे ख़रीदार असल में स्क्रॉल करते हैं।
रिज़ल्ट टाइलों में shippingPrice या स्टॉक की मात्रा नहीं होती; वे प्रोडक्ट पेज पर होते हैं। search endpoint को डिस्कवरी लेयर और product endpoint को डिटेल लेयर मानें, और जब आप एक ही शब्द दिन में कई बार क्रॉल करें तो withCache के साथ सर्च पेज cache करें।
रिस्पॉन्स में sortStrategy पुष्टि करता है कि otto.de ने असल में कौन-सा क्रम लागू किया। अगर आप कोई अज्ञात sortBy वैल्यू भेजते हैं, तो Otto अपने default पर लौट जाता है और यह फ़ील्ड आपको बता देता है।
संबंधित endpoints
प्रोडक्ट सर्च करें. पेजिंग के साथ कीवर्ड सर्च: हर प्रोडक्ट का टाइटल, कीमत, रेटिंग और इमेज।
प्रोडक्ट विवरण. URL से प्रोडक्ट पेज। अस्थायी रूप से उपलब्ध नहीं (otto.de bot protection), 502 लौटाता है और शुल्क नहीं लगता।
रिव्यू. किसी प्रोडक्ट के पेजिंग वाले रिव्यू।
Otto Search API प्राइसिंग: प्रति रिक्वेस्ट भुगतान
हर सर्च पेज एक रिक्वेस्ट है, उसका आकार चाहे जो हो – शब्द के हिसाब से Otto हर पेज पर 24 से 120 प्रोडक्ट दिखाता है। 50 कीवर्ड को उनके पहले तीन पेजों पर रोज़ ट्रैक करने में हर महीने लगभग 4,500 रिक्वेस्ट लगती हैं, जो Starter प्लान (€30) में आ जाती हैं। withCache एक ही शब्द के बार-बार लुकअप को एक upstream फ़ेच साझा करने देता है।
- Free
- 100 रिक्वेस्ट / महीना
- Starter
- 5,000 रिक्वेस्ट · €30
- Production
- 50,000 रिक्वेस्ट · €80
- Business
- 3,00,000 रिक्वेस्ट · €300
Otto Search API: अक्सर पूछे जाने वाले सवाल
कौन-सी sortBy वैल्यू सपोर्टेड हैं?
topseller (डिफ़ॉल्ट), preis-aufsteigend, preis-absteigend, neuheiten और bewertung – वही keys जो otto.de अपने sort मेन्यू में इस्तेमाल करता है। लागू क्रम sortStrategy में लौटाया जाता है।
एक पेज में कितने रिज़ल्ट होते हैं?
numberOfProducts हर रिस्पॉन्स में बताता है; कैटेगरी और डिवाइस लेआउट के हिसाब से otto.de आमतौर पर 24 से 120 टाइलें रेंडर करता है। पेज का तय आकार मानने के बजाय आगे बढ़ने के लिए nextPage और lastPage इस्तेमाल करें।
क्या मैं ब्रांड, रंग या प्राइस रेंज से फ़िल्टर कर सकता हूँ?
endpoint सिर्फ़ keyword, page और sortBy स्वीकार करता है। ब्रांड तक सीमित सर्च के लिए ब्रांड को keyword में डालें ("Vladon Highboard") और लौटाए गए फ़ील्ड से कीमत या manufacturer को client-side फ़िल्टर करें।
क्या sponsored प्रोडक्ट शामिल होते हैं?
हाँ, वे लिस्ट में ठीक वहीं दिखते हैं जहाँ otto.de उन्हें दिखाता है और उन पर sponsored: true होता है। ऑर्गेनिक रैंकिंग चाहिए तो उन्हें फ़िल्टर करके हटा दें।
क्या सर्च स्टॉक या शिपिंग लागत लौटाती है?
यह हर टाइल का deliveryMessage लौटाती है, जो उपलब्धता और डिलीवरी समय बताता है, लेकिन shippingPrice या मात्रा नहीं। उनके लिए dpUrl पर product endpoint कॉल करें।
संबंधित उपयोग के उदाहरण
अपनी पहली otto.de सर्च चलाएँ
फ़्री अकाउंट बनाएँ और एक मिनट से कम में सर्च रिज़ल्ट पेज JSON में फ़ेच करें – न ब्राउज़र ऑटोमेशन, न प्रॉक्सी।