seo/
google-autocomplete

best crm 같은 검색어의 앞부분을 보내면 Google 검색창 아래에 뜨는 자동완성 검색어를 표시 순서대로 받습니다. 국가와 언어는 원하는 대로 고릅니다.

Google Autocomplete API

Google 표시 순서
롱테일 키워드
국가·언어 선택
요청당 고정 요금
요청당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Google Autocomplete

Google 자동완성은 Google 검색창에 입력할 때 아래로 펼쳐지는 추천 검색어 목록으로, 해당 국가와 언어에서 사람들이 실제로 검색하는 내용을 반영합니다. 시작 문구에 대한 자동완성을 읽으면 롱테일 키워드, FAQ 주제, 제품 이름 아이디어를 빠르게 모을 수 있고, 같은 문구를 여러 시장에서 조회하면 나라별 수요 차이도 보입니다.

Google Autocomplete API 주요 기능

  • Google 순서 그대로의 자동완성각 행은 keyword에 담긴 추천 검색어 하나이며, rank는 목록에서의 위치입니다. 시작 문구 하나당 보통 15개 안팎입니다.
  • 바로 쓰는 검색 링크url은 추천 검색어마다 Google 검색을 열어, 키워드 뒤의 검색 결과 페이지를 확인할 때 편리합니다.
  • 시장별 자동완성location_code나 location_name, language_code나 language로 시장을 고르며, 각 행의 query에 시작 문구가, 함께 요청 언어가 기록됩니다.

Google Autocomplete API 매개변수

매개변수필수설명
query필수자동완성할 검색어의 앞부분(예: best crm)입니다.
location_code선택검색 시장의 위치 코드입니다. 기본값은 2840(미국)입니다.
location_name선택location_code 대신 쓰는 시장 이름으로, 입력하면 location_code보다 우선합니다.
language_code선택추천 검색어의 언어 코드입니다. 기본값은 en입니다.
language선택language_code 대신 쓰는 언어 이름으로, 입력하면 language_code보다 우선합니다.

Google Autocomplete API 사용 방법

시작 문구를 보내고 추천 검색어마다 한 행으로 받습니다.

  1. {"query": "best crm", "location_code": 2840, "language_code": "en"}을 /v1/seo/google-autocomplete에 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 추천 검색어를 rank 순서대로 읽습니다.
curl -X POST "https://api.socq.ai/v1/seo/google-autocomplete" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"best crm","location_code":2840,"language_code":"en"}'

Google Autocomplete API 추천 활용 사례

  • 시작 문구를 롱테일 키워드로 확장: 대표 키워드를 조회한 뒤 나온 추천 검색어를 하나씩 새 시작 문구로 다시 조회해, 사람들이 실제로 입력하는 말로 키워드 트리를 만듭니다.
  • FAQ와 콘텐츠용 질문 찾기: how, what, why, can 같은 말에 주제를 붙여 시작 문구로 쓰고, 사람들이 Google에 입력하기 시작하는 질문을 모읍니다.
  • 국가별 검색 관심 비교: 같은 시작 문구를 다른 지역·언어 설정으로 조회해 시장마다 어떤 수식어가 붙는지 확인합니다.
  • 제품명과 기능명 테스트: 검토 중인 이름의 앞부분을 입력하고 Google의 추천을 읽어, 헷갈리거나 다른 회사와 겹치는 연상을 미리 찾아냅니다.

Google Autocomplete API 활용 팁

  • 추천이 너무 넓게 나온다면 단어를 하나 더 붙이거나 공백 뒤에 글자 하나를 더해 Google이 더 좁은 완성어를 내도록 유도하세요.
  • 키워드를 대량으로 확장할 때는 시작 문구를 가로질러 keyword 기준으로 중복을 없애세요. 같은 완성어가 여러 시작 문구 아래에 자주 나옵니다.
  • 현지어 추천이 필요하다면 시장과 언어를 모두 설정하고 시작 문구도 그 언어로 쓰세요.

Google Autocomplete API 외에 SEO의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Google Organic SERP API — 검색어와 시장으로 실시간 Google 검색 결과 페이지 하나를 가져오며, 정규화된 도착 URL, 순위, 요소 유형, 전체 결과 상세를 포함합니다.
  • Keyword Difficulty API — 제출한 키워드 묶음의 오가닉 순위 난이도를 비교하며, 확인 가능한 각 키워드를 정규화된 점수와 함께 반환합니다.
  • Keyword Overview API — 제출한 키워드 묶음에 확인 가능한 수요, 유료 경쟁, 난이도, 월간 검색량, 검색 의도 맥락을 더해 보강합니다.
  • Keyword Search Volume API — 알고 있는 키워드의 검색량, CPC, 유료 경쟁, 월별 검색 추이를 측정합니다.
  • Keywords for Site API — 웹사이트 하나와 관련된 키워드를 생성하며, 확인 가능한 수요 측정값, 월별 추이, 시장 맥락, 전체 원본 행을 포함합니다.
  • Keyword Suggestions API — 시드 검색어 하나를 일치하는 롱테일 키워드로 확장하며, 확인 가능한 수요 측정값, 월별 추이, 검색 의도 맥락, 전체 원본 행을 포함합니다.

다른 플랫폼 둘러보기

SEO 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Google Autocomplete API — 자주 묻는 질문

Google Autocomplete API는 선택한 국가와 언어에서 검색어의 앞부분에 대해 Google이 추천하는 완성 검색어를 반환하는 API로, 추천마다 한 행씩 Google 표시 순서대로 정렬됩니다.

보통 15개 안팎이며, 해당 시작 문구에 Google이 보여 주는 추천에 따라 달라집니다.

네. 기본값은 미국(2840)과 영어(en)이며 location_code나 location_name, language_code나 language로 시장을 바꿀 수 있습니다.

추천 검색어 수와 관계없이 요청당 0.5크레딧입니다.