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

Google Search API का उपयोग करके एक Google सर्च प्रकार चुनें और उसकी रिक्वेस्ट भेजें। यह गाइड Quickstart पर आधारित है और 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

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

सर्च प्रकार चुनें

सर्च प्रकारinput.tbmरिक्वेस्ट इनपुट
Google Searchछोड़ेंq में सर्च क्वेरी
Google Imagesischq में इमेज सर्च क्वेरी
Google Locallclq में लोकल सर्च क्वेरी
Google Videosvidq में वीडियो सर्च क्वेरी
Google Shoppingshopq में शॉपिंग सर्च क्वेरी
Google Webwebq में वेब सर्च क्वेरी
Google Jobsjobsq में जॉब्स सर्च क्वेरी
Google Newsnwsq में न्यूज़ सर्च क्वेरी
Google Short Videossvidq में शॉर्ट वीडियो सर्च क्वेरी

ये एक ही एंडपॉइंट के सर्च मोड हैं। मोड बदलते समय HTTP URL, ऑथेंटिकेशन हेडर और एक्टर को अपरिवर्तित रखें।

नियमित वेब सर्च के लिए 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 reference

Google Images

इमेज सर्च रिक्वेस्ट करने के लिए tbm को isch पर सेट करें। नीचे दी गई रिक्वेस्ट डिफ़ॉल्ट Google डोमेन का उपयोग करती है।

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"
  }
}'

Google Images reference

Google Local

लोकल सर्च रिक्वेस्ट करने के लिए 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"
  }
}'

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

लोकल सर्च पेजिनेशन के लिए, start का मान 20 का गुणज होना चाहिए: 0, 20, 40, और इसी तरह।

Google Local reference

Google Videos

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,
    "tbm": "vid"
  }
}'

Google Videos reference

Google Shopping

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,
    "tbm": "shop"
  }
}'

Google Shopping reference

सामान्य सर्च कंट्रोल्स

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

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

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

रिजल्ट पढ़ें

  • 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 को लौटाए गए ID से बदलें। पूर्ण वर्कफ़्लो के लिए Results and Polling देखें।

रिस्पॉन्स सेक्शन सर्च प्रकार और क्वेरी के अनुसार भिन्न होते हैं। समर्पित API स्पेसिफिकेशन वर्तमान में सफल रिस्पॉन्स के लिए एक जेनेरिक ऑब्जेक्ट घोषित करते हैं; नियमित Google Search उदाहरण Images, Local, Videos या Shopping के लिए स्कीमा नहीं है।

संबंधित दस्तावेज़