एक Google क्वेरी केवल एक खोज अनुरोध का हिस्सा है। किसी ने लंदन और सिंगापुर में शोध करने वाले व्यक्ति को उसी शब्दों के लिए अलग-अलग परिणाम की आवश्यकता हो सकती है। यह गाइड दर्शाता है कि किसी देश, इंटरफ़ेस भाषा और शहर का अनुरोध कैसे किया जाए, फिर दोहराए बिना परिणाम पृष्ठों की एक छोटी संख्या को इकट्ठा करें URLs दो बार।
आप एक Python 3 स्क्रिप्ट का निर्माण करेंगे जो दोनों परिणामों को बचाता है और API द्वारा लौटाई गई खोज सेटिंग्स। यदि आप अपना पहला अनुरोध कर रहे हैं, तो शुरू करें Google खोज परिणाम CSV.
क्या ग्ल, hl और स्थान नियंत्रण
glइस तरह के रूप में दो पत्र देश कोड हैgb,usयाsg.hlGoogle इंटरफ़ेस भाषा का चयन करता है, जैसे किenयाde. यह एक गारंटी नहीं है कि हर वापसी पृष्ठ उस भाषा में लिखा गया है।locationएक खोज स्थान का अनुरोध करता है। इस तरह के रूप में स्पष्ट शहर के नाम का प्रयोग करेंLondon, England, United Kingdom, जब स्थानीय संदर्भ मामले होते हैं।
जब आप एक स्पष्ट खोज विन्यास चाहते हैं तो इन मापदंडों का उपयोग करें। एक स्थान खोज स्रोत का अनुरोध है, किसी विशेष व्यक्ति के ब्राउज़र के समान परिणामों की गारंटी नहीं है। खोज प्रकार, क्वेरी, समय और उपलब्ध डेटा प्रतिक्रिया को प्रभावित कर सकते हैं। निरीक्षण results[0].searchParameters इसके बजाय सेवा को असंतुष्ट करने के लिए हर मूल्य पर लागू किया गया।
अपने API कुंजी तैयार करें और बजट का अनुरोध करें
बनाना API कुंजी और सुनिश्चित करें कि खाता क्रेडिट उपलब्ध है। अपने पर्यावरण में कुंजी स्टोर करें, स्रोत नियंत्रण या ब्राउज़र JavaScript में नहीं। कोड केवल Python के मानक पुस्तकालय का उपयोग करता है।
export FLASHDATA_API_KEY='your-api-key'
export SEARCH_QUERY='coworking spaces'
export SEARCH_COUNTRY='gb'
export SEARCH_LANGUAGE='en'
export SEARCH_LOCATION='London, England, United Kingdom'
export SEARCH_MAX_PAGES='3'
num 1–100 परिणाम का अनुरोध करता है और page 1–100 स्वीकार करता है। लौटाई गई गिनती अनुरोधित गिनती से छोटी हो सकती है। प्रत्येक पृष्ठ एक अलग बिलेबल अनुरोध है। यह उदाहरण तीन पृष्ठों तक अनुरोध करता है, एक खाली पृष्ठ पर रुक जाता है, और स्वचालित रूप से असफल प्रस्तुतियों को वापस नहीं लेता है।
स्थानीयकृत परिणामों को इकट्ठा करना और उनके संदर्भ को संरक्षित करना
इसे सहेजें localized-search.py. यह प्रत्येक परिणाम के साथ अनुरोधित पृष्ठ को रिकॉर्ड करता है, मूल रखता है position यदि कोई वापस आ जाता है, और केवल सटीक डुप्लिकेट URLs को हटा देता है। यह जानबूझकर वैश्विक रैंकिंग की गणना नहीं करता है (page - 1) × num: वापसी की गिनती भिन्न हो सकती है।
import json
import os
from pathlib import Path
from urllib.error import HTTPError
from urllib.request import Request, urlopen
key = os.environ["FLASHDATA_API_KEY"]
max_pages = int(os.getenv("SEARCH_MAX_PAGES", "3"))
if not 1 <= max_pages <= 100:
raise ValueError("SEARCH_MAX_PAGES must be between 1 and 100")
query = os.getenv("SEARCH_QUERY", "coworking spaces")
settings = {
"gl": os.getenv("SEARCH_COUNTRY", "gb"),
"hl": os.getenv("SEARCH_LANGUAGE", "en"),
"location": os.getenv("SEARCH_LOCATION", "London, England, United Kingdom"),
"num": 10,
}
rows, pages, seen = [], [], set()
for page in range(1, max_pages + 1):
payload = {"source": "google_search", "query": query,
"params": {**settings, "page": page}}
request = Request(
"https://data.flashdata.dev/v1/queries/realtime",
data=json.dumps(payload).encode(), method="POST",
headers={"Content-Type": "application/json", "X-API-Key": key},
)
try:
with urlopen(request, timeout=60) as response:
body = json.load(response)
except HTTPError as error:
raise RuntimeError(f"Search failed: HTTP {error.code}. Check the request and account before resubmitting.") from error
if body.get("error") or body.get("status") != "done":
raise RuntimeError("Search did not complete. Check Request History before resubmitting.")
if not isinstance(body.get("results"), list) or not body["results"]:
raise RuntimeError("Expected a search result object")
result = body["results"][0]
organic = result.get("organic", [])
pages.append({"requestedPage": page, "requestedParams": payload["params"],
"reportedParams": result.get("searchParameters"),
"returnedCount": len(organic), "usage": body.get("usage")})
for item in organic:
link = item.get("link")
if link and link not in seen:
seen.add(link)
rows.append({"requestedPage": page, **item})
if not organic:
break
Path("localized-results.json").write_text(
json.dumps({"query": query, "pages": pages, "organic": rows}, indent=2),
encoding="utf-8",
)
print(f"Saved {len(rows)} unique URLs from {len(pages)} pages")
python3 localized-search.py
बाजारों की तुलना करने से पहले आउटपुट पढ़ें
JSON फ़ाइल में एक फ़ाइल शामिल है pages प्रत्येक पूर्ण अनुरोध और एक के लिए प्रवेश organic अद्वितीय लिंक की सरणी। रखना requestedParams और reportedParams अपने डेटा के साथ। एक अनुपस्थित क्षेत्र अनुपस्थित रहना चाहिए या null; एक प्रतिक्रिया के लिए एक देश या स्थान मान का निर्माण नहीं करना चाहिए जो एक की रिपोर्ट नहीं करता था।
दो बाजारों की तुलना करने के लिए, क्वेरी को रखने और पेज बजट को सुसंगत बनाने और देश, भाषा और स्थान को जानबूझकर बदलने का अनुरोध किया। यदि आपको ऐतिहासिक तुलना की आवश्यकता हो तो अपने आवेदन में रिकॉर्ड संग्रह समय। विभिन्न परिणाम सेट उन अनुरोधों से अवलोकन कर रहे हैं, जो स्थायी रैंक परिवर्तन का प्रमाण नहीं हैं।
क्यों एक पृष्ठ कम परिणाम हो सकता है?
खोज परिणामों में समृद्ध विशेषताओं के साथ-साथ कार्बनिक लिंक भी शामिल हो सकते हैं, और स्रोत अनुरोध की तुलना में कम कार्बनिक वस्तुओं को वापस कर सकता है। लौटाने वाली सरणी की गणना करें। एक खाली कार्बनिक पृष्ठ इस छोटी स्क्रिप्ट के लिए एक उचित रोक शर्त है; यह स्थापित नहीं है कि Google के पास कोई अन्य प्रासंगिक पृष्ठ नहीं है।
401/403 त्रुटियों के लिए, API कुंजी और अनुमतियों की जाँच करें। क्रेडिट या दर सीमा त्रुटियों के लिए, पहले खाते या अनुरोध दर मुद्दे को हल करें। नेटवर्क टाइमआउट यह साबित नहीं करता कि भुगतान का अनुरोध कभी निष्पादित नहीं किया गया था; इसे फिर से जमा करने से पहले अनुरोध History का निरीक्षण करें।
जारी रखें Google Search API पैरामीटर संदर्भ, async और बैच गाइड, या Google Search उत्पाद अवलोकन.