Google 쿼리는 검색 요청의 일부입니다. 런던과 싱가포르를 연구하는 누군가는 같은 단어에 대한 다른 결과를 필요로 할 수 있습니다. 이 가이드는 국가, 인터페이스 언어 및 도시를 요청하는 방법을 보여줍니다, 다음 중복 URLs를 두 번 계산하지 않고 결과 페이지의 작은 수를 수집.
Python 3 스크립트를 구축하여 결과를 모두 저장하고 API에 의해 반환된 검색 설정. 첫 번째 요청을 만드는 경우, 시작 Google 검색 결과 CSV.
gl, hl 및 위치 제어
gl같은 두 개의 letter 국가 코드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를 받아들입니다. 반환된 조사는 요청한 조사 보다는 더 작을 수 있습니다. 각 페이지는 별도의 청구 가능한 요청입니다. 이 예제는 3 페이지까지 요청, 빈 페이지에 중지, 자동으로 재발견되지 않습니다.
현지화된 결과를 수집하고 그들의 상황에 보존하십시오
이 저장하기 localized-search.py. 각 결과에 따라 요청된 페이지를 기록하고 원본을 유지합니다. position 1이 반환되고, 단지 정확한 중복 URLs를 제거합니다. 그것은 deliberately에서 글로벌 순위를 계산하지 않습니다 (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 귀하의 데이터로. absent 필드는 absent 또는 null를 유지해야합니다. 국가 또는 위치 값을 하나보고하지 않은 응답에 대 한 제조하지 마십시오.
두 시장을 비교하기 위해 쿼리를 유지하고 요청한 페이지 예산을 일관되게 유지하고 국가, 언어 및 위치 결정적으로 변경하십시오. 기록 수집 시간 귀하의 응용 프로그램에서 역사적 비교를 필요로합니다. 다른 결과 세트는 이러한 요청에서 관측, 영구적 인 순위 변경의 증거입니다.
왜 페이지가 더 적은 결과를 포함 할 수 있습니까?
검색 결과에는 풍부한 기능뿐만 아니라 유기 링크가 포함되며, 소스는 요청한 것보다 더 적은 유기 항목을 반환 할 수 있습니다. 반환된 배열을 계산합니다. 빈 유기 페이지는이 작은 스크립트에 대한 합리적인 중지 조건입니다. Google는 다른 관련 페이지를 가지고 있지 않다는 것을 설정하지 않습니다.
401/403 오류의 경우 API 키 및 권한 확인. 신용 또는 rate-limit 오류를 위해, 먼저 계정 또는 요청 시 발급을 해결합니다. 네트워크 타임아웃은 유료 요청이 실행되지 않았는지 증명하지 않습니다. 다시 제출하기 전에 요청 History를 검사합니다.
계속하기 Google Search API 모수 참고, async 및 일괄 가이드, 또는 Google Search 제품 개요.