Google API로 키워드 순위를 확인하는 방법 (2026 가이드)

Google API로 키워드 순위 확인하기는 직접 시도해 보기 전까지는 이미 해결된 문제처럼 보이는 작업입니다. rankings.get() 엔드포인트는 존재하지 않으며, 사람들이 가장 먼저 떠올리는 두 가지 Google API는 각각 실제로 묻고 싶은 것과는 미묘하게 다른 질문에 답합니다. Search Console Search Analytics 문서에서 시작하는 것이 좋습니다. 다만 여기서 말하는 “순위”가 무엇을 뜻하는지 이해하고 있어야 합니다.

Google에 공식 키워드 순위 API가 있습니까?

없습니다. Google은 키워드를 입력받아 google.com에서의 실시간 순위를 반환하는 API를 공개한 적이 없습니다. 이는 의도적입니다. 검색결과 페이지를 자동으로 조회하는 행위는 Google 약관에서 금지하고 있으며, Google에는 순위 추적 인프라를 제공할 상업적 이유가 없습니다.

대신 존재하는 것은 세 가지 부분적인 방법이며, 각각에는 분명한 한계가 있습니다:

Search Console API로 키워드 순위를 어떻게 가져옵니까?

searchAnalytics 엔드포인트를 query 차원으로 조회한 뒤 position 필드를 읽으세요. 이는 Google에서 직접 받는 자사 데이터이고, 무료이며, 키워드 개수 제한이 없습니다. 사이트가 노출수를 얻은 모든 검색어를 받아 볼 수 있습니다.

Python으로 작성한 실제 요청은 다음과 같습니다:

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

많은 사람이 놓치는 세 가지 한계

• 순위는 평균값이지 실제 등수가 아닙니다. 7.4라는 값은 7위에 있다는 뜻이 아닙니다. 노출이 여러 순위에 흩어져 평균이 7.4라는 뜻이며, 기기와 지역에 따라 3위에서 15위까지 걸쳐 있을 수 있습니다.
• 자사 사이트만 해당합니다. 경쟁사의 순위를 확인할 방법은 없습니다. Search Console은 설계상 속성 단위로 범위가 제한된 API입니다.
• 노출수가 0인 키워드는 보이지 않습니다. 60위에 노출되고 있더라도 아무도 그만큼 스크롤하지 않았다면, 해당 검색어는 데이터에 아예 나타나지 않습니다.

세 번째 항목이 리포팅을 조용히 망가뜨립니다. 아직 앞쪽 페이지에 진입하지 못한 키워드는 Search Console에 존재하지 않으므로, 이 API만으로는 60위에서 20위로 나아간 개선을 측정할 수 없습니다.

Custom Search JSON API로 순위를 확인할 수 있습니까?

기술적으로는 가능하지만, 의미 있는 방법은 아닙니다. Custom Search JSON API를 쓰려면 먼저 Programmable Search Engine을 만들어야 합니다. 웹 전체를 검색하도록 설정하더라도 자체 순위 산정 방식과 자체 제한이 적용되므로, 반환되는 순서는 google.com이 반환하는 순서와 다릅니다.

또한 무료 등급에서는 하루 100회로 제한되며, 유료 사용은 1000회 단위로 과금되고 하루 상한도 있습니다. 키워드 몇 개를 가끔 확인하는 용도라면 쓸 만합니다. 그러나 순위 추적 도구로 쓰면 그럴듯해 보이지만 조용히 틀린 수치를 만들어 내며, 이는 데이터가 아예 없는 것보다 나쁩니다.

Google을 직접 스크래핑하는 방법은 어떻습니까?

하지 마세요. 허가 없이 Google 검색을 자동으로 조회하는 행위는 Google 서비스 약관에 위배되며, 규모를 막론하고 IP 차단과 CAPTCHA 벽을 부릅니다. 정책 문제를 떠나 엔지니어링 현실도 만만치 않습니다. 검색결과는 개인화되고 지역화되며 점점 더 AI 기능과 함께 구성되므로, 스크래핑한 “순위”는 사이트에 아무 변화가 없어도 데이터센터, 지역, 세션에 따라 달라집니다.

경쟁사의 순위가 필요하다면, 상용 SERP API가 제공업체 약관상 허용되면서 운영도 안정적인 방법입니다. 유료 항목이며, 그 비용은 Google이 공개하지 않는 데이터에 대한 정직한 대가입니다. 내부에 인력을 두지 않고 이 파이프라인을 구축하고 모니터링해야 하는 기업은 보통 전문 업체를 부릅니다. 프랑스 최고의 데이터 분석 대행사 10곳 비교 자료에서 이런 리포팅을 구축해 주는 업체를 확인할 수 있습니다.

그렇다면 실제로 무엇을 구축해야 합니까?

대부분의 팀에게 현실적인 구조는 하이브리드이며, 다음과 같습니다:

• Search Console API를 뼈대로 삼습니다. 무료이고 키워드 수 제한이 없으며 자사 데이터이고, 실제로 어떤 검색어에서 노출수를 얻고 있는지 알려 주는 유일한 출처입니다.
• 엄선한 소수의 키워드에는 SERP API를 씁니다. 상업적으로 중요한 20개에서 30개 검색어를 경쟁사 순위까지 포함해 매일 확인합니다.
• AI 가시성 레이어를 더합니다. 이제 질문은 “몇 위인가”에 그치지 않고 “누군가 AI 어시스턴트에 물었을 때 인용되는가”로 넘어갑니다. 기존 순위 API는 여기에 전혀 답하지 못합니다.

직접 설계하고 싶지 않은 팀은 보통 전문 업체에 맡깁니다. 프랑스 최고의 SEO 대행사 10곳 비교 자료에서는 고객사를 위해 이 리포팅 스택을 운영해 주는 업체를 소개합니다.

마지막 항목은 먼 미래의 이야기가 아닙니다. AI 답변이 화면 안에서 질문을 해결해 버리면 10위든 3위든 결과는 같습니다. 클릭이 없습니다. 순위와 함께 인용을 추적하는 것이 Search Console MCP 서버와 AI 가시성 플랫폼이 만들어진 이유이며, 문서에서 설정 과정을 처음부터 끝까지 다룹니다.

결론

실시간 키워드 순위를 제공하는 공식 Google API는 없습니다. 자사의 평균 데이터에는 Search Console API를, 정확한 순위와 경쟁사 순위에는 서드파티 SERP API를 사용하고, 순위 작업에 Custom Search JSON API는 아예 쓰지 마세요. 잘못된 방법 위에 구축하는 것이 이 분야에서 가장 흔한 실수이며, 그 결과는 자신만만하게 부정확한 대시보드입니다.

그 파이프라인을 직접 구축하고 유지하고 싶지 않다면, Sorank가 Search Console을 연동하고 AI 인용을 한곳에서 추적합니다.