Amazon Scraper एंडपॉइंट्स

इस पृष्ठ पर प्रत्येक ऑपरेशन के लिए scraper.amazon एक्टर का उपयोग करें। input.type के साथ ऑपरेशन चुनें और इसके संबंधित इनपुट प्रदान करें।

अनुरोध और प्रमाणीकरण

POST https://api.scrapeless.com/api/v1/scraper/request
x-api-token: YOUR_API_KEY
Content-Type: application/json

YOUR_API_KEY को अपने Scrapeless API कुंजी से बदलें। actor और input वाला एक JSON ऑब्जेक्ट भेजें।

एक ऑपरेशन चुनें

ऑपरेशनinput.typeनीचे उपयोग किए गए इनपुट
प्रोडक्टproducturl, zip_code
सेलरsellerurl, zip_code
कीवर्ड सर्चkeywordskeywords, page, domain, zip_code
Rufusrufuskeywords, 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 देखें।

प्रोडक्ट API संदर्भ

सेलर

एक सेलर पेज 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 ऑब्जेक्ट के रूप में परिभाषित करता है। अपने एप्लिकेशन में सेलर फ़ील्ड्स को मैप करने से पहले लौटाए गए पेडलोड का निरीक्षण करें।

सेलर API संदर्भ

कीवर्ड सर्च

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सर्च-परिणाम पृष्ठ संख्या।
domainAmazon डोमेन सेटिंग; आधिकारिक उदाहरण com का उपयोग करता है।
departmentवैकल्पिक डिपार्टमेंट उपनाम, Amazon के i क्वेरी पैरामीटर के अनुरूप।
zip_codeडिलीवरी जानकारी के लिए पोस्टल कोड।

प्रकाशित प्रतिक्रिया में keyword, page, result, total_results_count, और url होते हैं। प्रोडक्ट एंट्री result.organic के अंतर्गत दिखाई देती हैं। प्रतिक्रिया उदाहरण अनुरोध उदाहरण से भिन्न क्वेरी और पृष्ठ के लिए है, इसलिए इसका उपयोग सटीक परिणामों की भविष्यवाणी करने के बजाय फ़ील्ड्स को समझने के लिए किया जाना चाहिए।

Amazon पैरामीटर गाइड पूर्णांक page मान निर्दिष्ट करता है, और अनुरोध उदाहरण 1 का उपयोग करता है; जनरेट किया गया ऑपरेशन स्कीमा वर्तमान में page को एक स्ट्रिंग के रूप में लेबल करता है। यह गाइड पैरामीटर गाइड और अनुरोध उदाहरण का अनुसरण करती है।

कीवर्ड सर्च API संदर्भ

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 फ्रैगमेंट्स वाला कच्चा कंटेंट।
metadatatype और rawUrl शामिल हैं।
result.user_queryक्वेरी टेक्स्ट।
result.productsक्वेरी के लिए लौटाए गए प्रोडक्ट एंट्री।
result.related_questionsसंबंधित प्रश्न।
result.sourcesडेटा स्रोत, यह फ़ील्ड हर प्रतिक्रिया में लौटाया नहीं जा सकता है। इसकी उपलब्धता प्रोडक्ट और प्रॉम्प्ट पर निर्भर करती है।

ऑपरेशन स्कीमा is_sse_data, is_get_question, और asin को भी सूचीबद्ध करता है, लेकिन उनके व्यवहार की व्याख्या नहीं करता है। ऊपर दस्तावेज़ीकृत अनुरोध से शुरू करें।

Rufus API संदर्भ

टास्क परिणाम हैंडल करें

एक 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 एक ही फ़ील्ड लेआउट साझा नहीं करते हैं।