A Google การสืบค้นเป็นเพียงส่วนหนึ่งของการร้องขอการค้นหา บาง คน ที่ ค้นคว้า เกี่ยว กับ ลอนดอน และ คน ที่ กําลัง วิจัย สิงคโปร์ อาจ ต้องการ ผล ที่ ต่าง ออก ไป สําหรับ คํา พูด เดียว กัน. มัคคุเทศก์นี้แสดงให้เห็นวิธีการร้องขอประเทศภาษาและเมือง จากนั้นรวบรวมจํานวนน้อยของผลลัพธ์ หน้าโดยไม่นับซ้ํา URLs สองครั้ง
คุณจะสร้าง Python 3 สคริปต์ที่บันทึกทั้งผลลัพธ์และการตั้งค่าการค้นหาที่ส่งกลับมาโดย API. ถ้าคุณกําลังขอครั้งแรกของคุณ เริ่มที่ Google ผลการค้นหาไปยัง CSV.
อะไร, hl และการควบคุมตําแหน่ง
glเป็นรหัสประเทศสองอักษร เช่นgb,usหรือsg.hlเลือก Google ภาษาส่วนติดต่อ เช่น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▪ อย่า สร้าง ประเทศ หรือ ทํา ราย ได้ ใน ตําแหน่ง ที่ ไม่ มี การ รายงาน.
เพื่อ เปรียบ เทียบ ตลาด สอง แห่ง ให้ ตรวจ สอบ และ เรียก เก็บ งบ หน้า อยู่ เสมอ และ เปลี่ยน ประเทศ, ภาษา และ สถาน ที่ โดย เจตนา. บันทึกเวลาในใบสมัครของคุณ ถ้าคุณต้องการการเปรียบเทียบทางประวัติศาสตร์ ผล ที่ แตก ต่าง กัน ก็ คือ การ สังเกต จาก คํา ขอ เหล่า นั้น ไม่ ใช่ การ พิสูจน์ การ เปลี่ยน ตําแหน่ง ถาวร.
เหตุ ใด หน้า หนึ่ง อาจ มี ผล น้อย กว่า?
ผล ของ การ ค้น หา อาจ รวม ถึง ลักษณะ ที่ หลาก หลาย รวม ทั้ง ส่วน เชื่อม ต่อ ทาง อินทรีย์ และ แหล่ง นี้ อาจ นํา สิ่ง ของ อินทรีย์ กลับ มา น้อย กว่า ที่ ต้องการ. นับอาร์เรย์กลับมา หน้าเปล่า Original เป็นเงื่อนไขหยุดที่เหมาะสมสําหรับสคริปต์ขนาดเล็กนี้; มันไม่ได้สร้าง Google ไม่มีหน้าอื่นที่เกี่ยวข้อง
สําหรับ 401/403 ความผิดพลาด, ตรวจสอบ API กุญแจและสิทธิ์ที่อนุญาต สําหรับค่าเครดิตหรือค่าชดเชยที่ผิดพลาด ให้แก้บัญชี หรือร้องขออัตราก่อน เวลาหมดเวลาของเครือข่ายไม่พิสูจน์ว่าคําขอที่ต้องจ่ายไม่เคยถูกประมวลผล; ตรวจสอบการร้องขอ History ก่อนที่จะส่งมันอีกครั้ง
ทําต่อไป Google Search API การอ้างอิงพารามิเตอร์, คู่มือ Async and preet, หรือ Google Search ภาพรวมของผลิตภัณฑ์.