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/jsonYOUR_API_KEY को अपने Scrapeless API कुंजी (key) से बदलें। actor और input युक्त एक JSON ऑब्जेक्ट भेजें।
सर्च प्रकार चुनें
| सर्च प्रकार | input.tbm | रिक्वेस्ट इनपुट |
|---|---|---|
| Google Search | छोड़ें | q में सर्च क्वेरी |
| Google Images | isch | q में इमेज सर्च क्वेरी |
| Google Local | lcl | q में लोकल सर्च क्वेरी |
| Google Videos | vid | q में वीडियो सर्च क्वेरी |
| Google Shopping | shop | q में शॉपिंग सर्च क्वेरी |
| Google Web | web | q में वेब सर्च क्वेरी |
| Google Jobs | jobs | q में जॉब्स सर्च क्वेरी |
| Google News | nws | q में न्यूज़ सर्च क्वेरी |
| Google Short Videos | svid | q में शॉर्ट वीडियो सर्च क्वेरी |
ये एक ही एंडपॉइंट के सर्च मोड हैं। मोड बदलते समय HTTP URL, ऑथेंटिकेशन हेडर और एक्टर को अपरिवर्तित रखें।
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 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 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 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 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"
}
}'सामान्य सर्च कंट्रोल्स
इन फ़ील्ड्स को input के अंदर सेट करें:
| पैरामीटर | उद्देश्य |
|---|---|
q | आवश्यक सर्च क्वेरी। |
gl | सर्च देश, जैसे us। |
hl | सर्च भाषा, जैसे en। |
google_domain | Google डोमेन; डिफ़ॉल्ट 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 के लिए स्कीमा नहीं है।