Amazon Scraper एंडपॉइंट्स
इस पृष्ठ पर प्रत्येक ऑपरेशन के लिए scraper.amazon एक्टर का उपयोग करें। input.type के साथ ऑपरेशन चुनें और इसके संबंधित इनपुट प्रदान करें।
अनुरोध और प्रमाणीकरण
POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/jsonYOUR_API_KEY को अपने Scrapeless API कुंजी से बदलें। actor और input वाला एक JSON ऑब्जेक्ट भेजें।
एक ऑपरेशन चुनें
| ऑपरेशन | input.type | नीचे उपयोग किए गए इनपुट |
|---|---|---|
| प्रोडक्ट | product | url, zip_code |
| सेलर | seller | url, zip_code |
| कीवर्ड सर्च | keywords | keywords, page, domain, zip_code |
| Rufus | rufus | keywords, domain |
प्रोडक्ट
एक Amazon प्रोडक्ट URL प्रदान करें। प्रोडक्ट स्कीमा को url की आवश्यकता होती है; zip_code डिलीवरी-स्थान की जानकारी प्रदान करता है।
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.amazon",
"input": {
"type": "product",
"url": "https://www.amazon.com/dp/B0BQXHK363",
"zip_code": ""
}
}'प्रकाशित प्रतिक्रिया में asin, title, availability, final_price, rating, reviews_count, images, और variations शामिल हैं। संक्षिप्त प्रतिक्रिया उदाहरण के लिए Quickstart देखें।
सेलर
एक सेलर पेज URL प्रदान करें। zip_code शामिल करें: सेलर स्कीमा इसे आवश्यक के रूप में चिह्नित करता है, और इसके अनुरोध उदाहरण में एक खाली स्ट्रिंग का उपयोग किया गया है।
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.amazon",
"input": {
"type": "seller",
"url": "https://www.amazon.com/sp?seller=A2XZ7JICGUQ1CX",
"zip_code": ""
}
}'सेलर संदर्भ सफल प्रतिक्रिया को फ़ील्ड-स्तरीय स्कीमा या उदाहरण के बिना एक JSON ऑब्जेक्ट के रूप में परिभाषित करता है। अपने एप्लिकेशन में सेलर फ़ील्ड्स को मैप करने से पहले लौटाए गए पेडलोड का निरीक्षण करें।
कीवर्ड सर्च
keywords में सर्च टेक्स्ट प्रदान करें। सर्च-परिणाम पृष्ठ चुनने के लिए page का उपयोग करें। नीचे दिया गया उदाहरण दस्तावेज़ीकृत संख्यात्मक पृष्ठ मान का अनुसरण करता है और Amazon.com के लिए domain: "com" का उपयोग करता है; यह वैकल्पिक डिपार्टमेंट फ़िल्टर को छोड़ देता है।
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.amazon",
"input": {
"type": "keywords",
"keywords": "Iphone+14+Pro+512GB",
"page": 1,
"domain": "com",
"zip_code": ""
}
}'| इनपुट | उपयोग |
|---|---|
keywords | सर्च कीवर्ड; ऑपरेशन स्कीमा द्वारा आवश्यक। |
page | सर्च-परिणाम पृष्ठ संख्या। |
domain | Amazon डोमेन सेटिंग; आधिकारिक उदाहरण com का उपयोग करता है। |
department | वैकल्पिक डिपार्टमेंट उपनाम, Amazon के i क्वेरी पैरामीटर के अनुरूप। |
zip_code | डिलीवरी जानकारी के लिए पोस्टल कोड। |
प्रकाशित प्रतिक्रिया में keyword, page, result, total_results_count, और url होते हैं। प्रोडक्ट एंट्री result.organic के अंतर्गत दिखाई देती हैं। प्रतिक्रिया उदाहरण अनुरोध उदाहरण से भिन्न क्वेरी और पृष्ठ के लिए है, इसलिए इसका उपयोग सटीक परिणामों की भविष्यवाणी करने के बजाय फ़ील्ड्स को समझने के लिए किया जाना चाहिए।
Amazon पैरामीटर गाइड पूर्णांक page मान निर्दिष्ट करता है, और अनुरोध उदाहरण 1 का उपयोग करता है; जनरेट किया गया ऑपरेशन स्कीमा वर्तमान में page को एक स्ट्रिंग के रूप में लेबल करता है। यह गाइड पैरामीटर गाइड और अनुरोध उदाहरण का अनुसरण करती है।
Rufus
type को rufus पर सेट करें। ऑपरेशन स्कीमा द्वारा keywords और domain दोनों आवश्यक हैं। कीवर्ड सर्च उदाहरण में उपयोग किए गए com फॉर्मेट के बजाय एक पूर्ण Amazon डोमेन, जैसे www.amazon.es, का उपयोग करें।
curl --request POST 'https://api.scrapeless.com/api/v1/scraper/request' \
--header 'x-api-token: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"actor": "scraper.amazon",
"input": {
"type": "rufus",
"keywords": "macbook",
"domain": "www.amazon.es"
}
}'प्रकाशित प्रतिक्रिया में निम्नलिखित शामिल हैं:
| फ़ील्ड | API उदाहरण में दिखाया गया कंटेंट |
|---|---|
html | इवेंट रिकॉर्ड और HTML फ्रैगमेंट्स वाला कच्चा कंटेंट। |
metadata | type और rawUrl शामिल हैं। |
result.user_query | क्वेरी टेक्स्ट। |
result.products | क्वेरी के लिए लौटाए गए प्रोडक्ट एंट्री। |
result.related_questions | संबंधित प्रश्न। |
result.sources | डेटा स्रोत, यह फ़ील्ड हर प्रतिक्रिया में लौटाया नहीं जा सकता है। इसकी उपलब्धता प्रोडक्ट और प्रॉम्प्ट पर निर्भर करती है। |
ऑपरेशन स्कीमा is_sse_data, is_get_question, और asin को भी सूचीबद्ध करता है, लेकिन उनके व्यवहार की व्याख्या नहीं करता है। ऊपर दस्तावेज़ीकृत अनुरोध से शुरू करें।
टास्क परिणाम हैंडल करें
एक HTTP 200 प्रतिक्रिया में पूर्ण परिणाम शामिल होता है। एक HTTP 201 प्रतिक्रिया का अर्थ है कि प्रोसेसिंग अभी भी चल रही है; उसका taskId सेव करें और उस टास्क को इसके साथ पुनः प्राप्त करें:
curl --request GET 'https://api.scrapeless.com/api/v1/scraper/result/YOUR_TASK_ID' \
--header 'x-api-token: YOUR_API_KEY'YOUR_TASK_ID को अपने अनुरोध द्वारा लौटाए गए ID से बदलें। पोलिंग अंतराल और पुनः प्रयास सीमाओं के लिए Results and Polling का अनुसरण करें।
HTTP स्टेटस कोड के साथ-साथ एरर बॉडी का भी निरीक्षण करें। एक 400 प्रतिक्रिया में code: 20500 और message: "scraping failed" शामिल हो सकता है; यह एक सफल डेटा प्रतिक्रिया नहीं है। पुनः प्रयास करने से पहले टारगेट और अनुरोध इनपुट की जांच करें।
पैरामीटर संदर्भ
डिपार्टमेंट उपनामों और अन्य दस्तावेज़ीकृत इनपुट के लिए Amazon API Parameters का उपयोग करें। चयनित type के लिए परिणामों को पार्स करें; प्रोडक्ट, कीवर्ड सर्च, सेलर और Rufus एक ही फ़ील्ड लेआउट साझा नहीं करते हैं।