seo/
keyword-overview

한 시장에서 알고 있는 키워드 최대 1,000개에 대해 제공 가능한 검색량, CPC, 유료 경쟁도, 난이도, 월별 추이, 검색 의도를 정규화된 레코드로 보강합니다.

Keyword Overview API

통합 키워드 지표
최대 1,000개 키워드
수요·경쟁 신호
키워드당 0.15 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Keyword Overview

키워드 개요 레코드는 알고 있는 검색어에 대해 검색 수요, 유료 경쟁도, 자연 검색 난이도, 월별 관측값, 분류된 검색 의도를 한데 묶어 보여 줍니다. 이처럼 서로 보완하는 신호는 키워드 목록 정보 보강, 기회 비교, 리서치 분류, 시간 흐름을 고려한 수요 분석에 활용할 수 있습니다.

Keyword Overview API 주요 기능

  • 알고 있는 키워드 일괄 입력선택한 검색 시장과 언어 조건 하나로 준비한 키워드 1~1,000개를 평가합니다.
  • 수요와 유료 검색 필드수요와 유료 시장 비교를 위해 확인 가능한 검색량, CPC, 경쟁도, 경쟁 수준, 경쟁 지수, 월별 관측값을 그대로 보존합니다.
  • 자연 검색 난이도와 검색 의도확인 가능한 키워드 난이도와 검색 의도 정보를 수요 필드와 함께 제공하므로, 서로 다른 신호가 같은 검색어에 연결된 채로 유지됩니다.
  • 개요 행 전체 유지keyword_info, keyword_properties, 검색 결과 메타데이터 등 반환된 다른 객체가 있으면 extra에 그대로 보관합니다.

Keyword Overview API 매개변수

매개변수필수설명
keywords필수알고 있는 비어 있지 않은 키워드 1~1,000개의 목록으로, 필수 값입니다. 항목당 최대 80자까지 사용할 수 있습니다.
location_code선택양의 정수인 검색 시장 코드입니다. 플레이그라운드의 기본값은 미국을 뜻하는 2840입니다.
location_name선택location_code 대신 쓸 수 있는 검색 시장 이름으로, 선택 값입니다. 입력하면 location_code보다 우선합니다.
language_code선택일괄 요청 전체에 적용되는 길이 2~10자의 검색 언어 코드입니다. 플레이그라운드의 기본값은 en입니다.
language선택language_code 대신 쓸 수 있는 검색 언어 이름으로, 선택 값입니다. 입력하면 language_code보다 우선합니다.
results_limit선택1에서 2,000 사이의 결과 수 제한으로, 선택 값입니다.

Keyword Overview API 사용 방법

알고 있는 키워드의 한정된 목록을 코드 기반 시장 설정과 함께 제출하고, 비동기 결과 레코드에서 정규화된 필드와 개요 객체 전체를 읽습니다.

  1. 각각 80자 이하인 비어 있지 않은 알고 있는 키워드 1~1,000개를 준비합니다.
  2. keywords를 location_code, language_code와 함께 /v1/seo/keyword-overview로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, 정규화 필드로 승격되지 않은 원본 필드는 extra.keyword_info나 extra.keyword_properties에서 확인합니다. has_more가 true인 동안 next_cursor를 따라갑니다.
curl -X POST "https://api.socq.ai/v1/seo/keyword-overview" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["keyword research","seo tools"],"location_code":2840,"language_code":"en"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Keyword Overview API 추천 활용 사례

  • 키워드 목록 정보 보강: 반환된 keyword_info와 keyword_properties 필드를 준비한 키워드 목록에 결합해 공통 리서치 레코드를 만듭니다.
  • 수요·경쟁 비교: 유료 신호와 자연 검색 신호를 서로 바꿔 쓸 수 있는 것으로 취급하지 않고, 검색량, CPC, 유료 경쟁도, 키워드 난이도를 비교합니다.
  • 검색 의도·추이별 분류: 검색 의도 정보를 월별 검색 관측값과 함께 사용해, 알고 있는 키워드를 예상 목적과 수요 패턴별로 정리합니다.

Keyword Overview API 활용 팁

  • 요금은 입력 개수를 기준으로 계산되므로, 제출 전에 키워드의 중복을 제거하세요.
  • 키워드를 비교할 때 선택한 검색 환경이 일관되도록 location_code와 language_code를 고정하세요.
  • 이 일괄 요청은 keywords 배열로 제어되고 개요 작업에는 문서화된 결과 수 제한이 없으므로 results_limit은 생략하세요.
  • 원본 값이 모두 정규화된 최상위 필드로 승격되는 것은 아니므로, 개요 전체를 보려면 extra.keyword_info와 extra.keyword_properties를 읽으세요.
  • 없는 필드는 숫자 0이 아니라 확인할 수 없는 데이터로 취급하고, 배열 순서가 아니라 키워드로 반환 레코드를 대응시키세요.
  • CPC와 경쟁도는 유료 검색 신호로 해석하고, keyword_difficulty는 자연 검색 경쟁 추정치를 나타낸다는 점을 구분하세요.

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

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

다른 플랫폼 둘러보기

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

Keyword Overview API — 자주 묻는 질문

Keyword Overview API는 한 검색 시장에서 알고 있는 키워드 1~1,000개의 정보를 보강하는 프로그래밍 인터페이스입니다. 데이터가 있는 키워드마다 확인 가능한 수요, 유료 경쟁도, 자연 검색 난이도, 월별 검색량, 검색 의도, 원본 행 전체 필드를 반환합니다.

필수인 keywords 배열이 일괄 요청을 정의하며, 각각 80자 이하인 비어 있지 않은 문자열 1~1,000개를 받습니다. location_code와 language_code는 플레이그라운드에서 사용하는 검색 환경을 선택합니다.

정규화된 metrics, monthly_searches, search_intent를 먼저 읽은 다음, 승격되지 않은 원본 필드는 extra.keyword_info와 extra.keyword_properties에서 확인하세요. extra 안의 키는 선택 사항이며 유동적입니다.

아니요. CPC와 경쟁도는 유료 검색 신호를 나타내고 keyword_difficulty는 자연 검색 순위 경쟁을 추정하므로, 각 필드를 해당 목적의 비교에 사용하세요.

제출한 키워드 1개마다 0.15 SocQ 크레딧이 차감되며, 반환 행이 생성되지 않는 입력도 포함됩니다. 따라서 키워드 두 개가 기본으로 들어 있는 플레이그라운드 요청의 예상 비용은 0.3 크레딧입니다.