순위는 시장마다 다릅니다 — 같은 키워드도 미국, 브라질, 독일에서 완전히 다른 결과를 보일 수 있습니다. 국가 파라미터가 있는 Google Search API를 사용하면 각 시장을 정확하게 추적할 수 있습니다. serp.cheap으로 하는 방법은 다음과 같습니다.
gl 파라미터
gl은 올바른 TLD와 지역 언어를 사용해 어느 국가의 Google에 쿼리할지 선택합니다:
import requests
def rank_in(keyword, domain, gl):
data = requests.post("https://api.serp.cheap/v1/search",
headers={"X-API-Key": "YOUR_KEY"},
json={"q": keyword, "gl": gl}).json()
for r in data["organic"]:
if domain in r["link"]:
return r["position"]
return None
for market in ["us", "gb", "de", "br"]:
print(market, rank_in("running shoes", "nike.com", market))지원 국가
us, br, gb, de, fr, es, it, mx, ca, au, jp, nl — 12개 시장, 각각 올바른 Google TLD와 언어를 사용합니다. 한 국가 내에서 표시 언어를 재정의하려면 hl을 추가하세요 (예: 캐나다에서 프랑스어 결과).
도시 단위 의도
serp.cheap은 국가 단위로 현지화합니다. 도시나 동네 단위 의도의 경우, 위치를 쿼리에 넣고 — "emergency plumber austin tx" — gl을 해당 국가로 고정하세요. 그러면 해당 문구에 대한 로컬 의도 SERP를 포착합니다.
다중 시장 대시보드 구축
키워드 목록을 gl 값들에 걸쳐 반복하고 (date, keyword, market, position)을 저장하세요. 이제 위치 인식 순위 추적기가 생겼습니다 — 저장/스케줄링 패턴은 Python으로 순위 추적기 만들기를 참고하세요.
비용
시장별 키워드당 요청 한 건. 50개 키워드 × 4개 시장을 매일 = 200건 요청 ≈ 신규 조회 시 하루 $0.12, 캐시 적중 시 더 저렴합니다.