본문으로 건너뛰기
KO
API 키 받기

Google Search / Python

Google Search API: 국가, 언어 및 질 Python

로컬라이제이션 Google 결과를 요청하려면 gl, hl 및 위치를 사용하여 안전하게 파고하고 Python로 반품 된 검색 설정을 저장하십시오.

FlashData · 게시됨

몇몇 결과 페이지와 함께 전 세계 현지화 검색 결과

Google 쿼리는 검색 요청의 일부입니다. 런던과 싱가포르를 연구하는 누군가는 같은 단어에 대한 다른 결과를 필요로 할 수 있습니다. 이 가이드는 국가, 인터페이스 언어 및 도시를 요청하는 방법을 보여줍니다, 다음 중복 URLs를 두 번 계산하지 않고 결과 페이지의 작은 수를 수집.

Python 3 스크립트를 구축하여 결과를 모두 저장하고 API에 의해 반환된 검색 설정. 첫 번째 요청을 만드는 경우, 시작 Google 검색 결과 CSV.

gl, hl 및 위치 제어

  • gl 같은 두 개의 letter 국가 코드 gb, us 또는 sg.

  • hl Google 인터페이스 언어 선택 en 또는 de. 모든 반환 페이지는 해당 언어로 작성된 보증이 아닙니다.

  • location 자주 묻는 질문 맑고 깨끗한 도시 이름을 사용하십시오. London, England, United Kingdom, 로컬 컨텍스트가 중요할 때.

명시된 검색 구성을 원할 때 이러한 매개 변수를 사용하십시오. 해당 이용 후기에 달린 코멘트가 없습니다. 검색 유형, 쿼리, 타이밍 및 사용 가능한 데이터는 응답에 영향을 줄 수 있습니다. 검사기 results[0].searchParameters 서비스 대신 모든 값에 적용되지 않는 서비스.

API 키 및 요청 예산 준비

제품정보 API 열쇠 계정이 유효한지 확인합니다. 소스 제어 또는 브라우저 JavaScript에서 환경의 열쇠를 저장하십시오. 코드는 Python의 표준 라이브러리만 사용합니다.

bash
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: 반환된 카운트는 다를 수 있습니다.

python
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")
bash
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 제품 개요.