Google Search API एंडपॉइंट्स

Google खोज प्रकार का चयन करें और Google Search API का उपयोग करके उसका अनुरोध भेजें। यह गाइड त्वरित शुरुआत पर आधारित है और Scrapeless API संदर्भ में समर्पित प्रविष्टियों के साथ पाँच खोज प्रकारों को कवर करती है।

सभी पांच एक ही HTTP एंडपॉइंट और एक्टर scraper.google.search का उपयोग करते हैं। input.tbm मान खोज प्रकार का चयन करता है।

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

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

अपनी Scrapeless API कुंजी के साथ YOUR_API_KEY को प्रतिस्थापित करें। actor और input युक्त एक JSON ऑब्जेक्ट भेजें।

एक खोज प्रकार चुनें

खोज प्रकार	`input.tbm`	अनुरोध इनपुट
Google Search	उपेक्षित करें	में खोज क्वेरी `q`
गूगल इमेजेज़	`isch`	में छवि खोज क्वेरी `q`
गूगल लोकल	`lcl`	में स्थानीय खोज क्वेरी `q`
गूगल वीडियोज़	`vid`	में वीडियो खोज क्वेरी `q`
गूगल शॉपिंग	`shop`	में शॉपिंग खोज क्वेरी `q`

ये एक ही एंडपॉइंट के खोज मोड हैं। मोड बदलते समय HTTP URL, प्रमाणीकरण हेडर और actor को अपरिवर्तित रखें।

Google Search

नियमित वेब खोज के लिए tbm को उपेक्षित करें।

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.google.search",
  "input": {
    "q": "coffee",
    "hl": "en",
    "gl": "us"
  }
}'

त्वरित शुरुआत में एक वेब-खोज प्रतिक्रिया शामिल है जिसमें organic_results, pagination और अन्य क्वेरी-निर्भर खंड हैं। यह न मानें कि हर क्वेरी हर खंड लौटाती है।

Google Search संदर्भ

गूगल इमेजेज़

छवि खोज का अनुरोध करने के लिए tbm को isch पर सेट करें। नीचे दिया गया अनुरोध डिफ़ॉल्ट गूगल डोमेन का उपयोग करता है।

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.google.search",
  "input": {
    "q": "Apple Iphone16",
    "hl": "en",
    "gl": "us",
    "tbm": "isch"
  }
}'

गूगल इमेजेज़ संदर्भ

गूगल लोकल

स्थानीय खोज का अनुरोध करने के लिए tbm को lcl पर सेट करें।

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.google.search",
  "input": {
    "q": "coffee shops",
    "hl": "en",
    "gl": "us",
    "tbm": "lcl"
  }
}'

शहर-स्तरीय लक्षित खोज के लिए, location के अंदर input जोड़ें, जैसे "Austin, Texas, United States"। एक ही अनुरोध में केवल location या uule में से एक का उपयोग करें, दोनों का नहीं।

स्थानीय खोज के पृष्ठांकन के लिए, start को 20 का गुणज होना चाहिए: 0, 20, 40, और इसी तरह।

गूगल लोकल संदर्भ

गूगल वीडियोज़

tbm को vid पर सेट करें। यह उदाहरण समर्पित API संदर्भ में दिखाए गए अनुरोध फ़ील्ड्स को बनाए रखता है।

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.google.search",
  "input": {
    "engine": "google.search",
    "q": "Coffee",
    "google_domain": "google.com",
    "start": 0,
    "num": 10,
    "tbm": "vid"
  }
}'

गूगल वीडियोज़ संदर्भ

गूगल शॉपिंग

tbm को shop पर सेट करें। यह उदाहरण समर्पित API संदर्भ में दिखाए गए अनुरोध फ़ील्ड्स को बनाए रखता है।

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.google.search",
  "input": {
    "engine": "google.search",
    "q": "Coffee",
    "google_domain": "google.com",
    "start": 0,
    "num": 10,
    "tbm": "shop"
  }
}'

गूगल शॉपिंग संदर्भ

सामान्य खोज नियंत्रण

इन फ़ील्ड्स को input के अंदर सेट करें:

पैरामीटर	उद्देश्य
`q`	आवश्यक खोज क्वेरी।
`gl`	खोज देश, जैसे `us`।
`hl`	खोज भाषा, जैसे `en`।
`google_domain`	गूगल डोमेन; डिफ़ॉल्ट रूप से `google.com` है।
`location`	खोज स्रोत, शहर के स्तर पर निर्दिष्ट करना वरीय है।
`uule`	एन्कोडेड गूगल स्थान; `location` के साथ परस्पर अनन्य।
`start`	परिणाम ऑफ़सेट। वेब खोज `0`, `10`, `20` आदि का उपयोग करती है।
`num`	अनुरोधित अधिकतम परिणाम संख्या।
`tbs`	उन्नत खोज फ़िल्टर।

पैरामीटर संदर्भ चेतावनी देता है कि num विलंबता बढ़ा सकता है या विशेष परिणाम प्रकारों को प्रभावित कर सकता है। आवश्यकता होने तक इसे छोड़ दें; अनुरोधित गणना की गारंटी उतने परिणामों की नहीं होती। ऊपर दिए गए वीडियो और शॉपिंग उदाहरण दस्तावेज़ीकृत मान 10 को बनाए रखते हैं।

पूर्ण पैरामीटर विवरण के लिए Google Search पैरामीटर देखें। वहां सूचीबद्ध वर्तमान डिवाइस समर्थन डेस्कटॉप है।

परिणाम पढ़ें

HTTP 200: JSON परिणाम पढ़ें।
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 को प्रतिस्थापित करें। पूर्ण कार्यप्रवाह के लिए परिणाम और पोलिंग देखें।

प्रतिक्रिया अनुभाग खोज प्रकार और क्वेरी के अनुसार भिन्न होते हैं। समर्पित API विशिष्टताएँ वर्तमान में सफल प्रतिक्रियाओं के लिए एक सामान्य ऑब्जेक्ट की घोषणा करती हैं; नियमित Google Search उदाहरण इमेज, स्थानीय, वीडियो या शॉपिंग के लिए कोई स्कीमा नहीं है।