seo/
related-keywords

시드 키워드 하나와 연관 검색 경로로 이어진 검색어를 찾아 키워드 지표, 월별 수요, 검색 의도, 연관 깊이를 정규화된 레코드로 반환합니다.

Related Keywords API

연관 검색 그래프
깊이 조절
키워드 측정값
결과당 0.1 크레딧
준비됨
README

SocQ 작성 · 업데이트

Related Keywords

연관 키워드는 연관 검색어 그래프로 이어진 검색어로, 깊이와 함께 수요, CPC, 경쟁도, 난이도, 검색 의도 신호를 담고 있습니다. 이러한 관계와 측정값은 인접 주제 발굴, 주제 맵 확장, 후보 키워드 비교에 활용할 수 있습니다.

Related Keywords API 주요 기능

  • 연관 검색 그래프 확장구문 포함 여부를 따지지 않고, 시드 하나에서 0~4 범위의 depth 값에 따라 직접 또는 재귀적으로 이어진 검색어를 따라갑니다.
  • 키워드 측정값 객체연결된 검색어마다 제공되는 검색량, CPC, 광고 경쟁도, 월별 추이, 난이도, 검색 의도 정보를 반환합니다.
  • 연관 관계 맥락 보존원본 깊이, 연관 키워드 경로, keyword_data 전체, 그 밖의 가변 필드를 extra 필드에 보존하므로 그래프를 자세히 해석할 수 있습니다.

Related Keywords API 매개변수

매개변수필수설명
query필수시드가 되는 키워드 또는 구문으로, 비어 있지 않아야 하는 필수 값입니다. 작업 하나에 query 하나만 받습니다.
location_code선택검색 시장을 나타내는 양수 코드로, 선택 값입니다.
location_name선택location_code 대신 쓸 수 있는 검색 시장 이름으로, 선택 값입니다. 입력하면 location_code보다 우선합니다.
language_code선택2~10자의 검색 언어 코드로, 선택 값입니다.
language선택language_code 대신 쓸 수 있는 검색 언어 이름으로, 선택 값입니다. 입력하면 language_code보다 우선합니다.
depth선택0~4 범위의 연관 깊이입니다. 기본값 1은 직접 연결된 검색어를 반환합니다.
results_limit선택요청할 연관 키워드의 최대 개수로, 1~1,000 범위입니다. 실제로는 더 적은 행이 반환될 수 있습니다.
offset선택요청한 결과 구간을 수집하기 전에 건너뛸 원본 행의 수로, 0부터 시작합니다.

Related Keywords API 사용 방법

시드 검색어 하나를 연관 깊이, 시장 설정, 제한된 결과 구간과 함께 제출하고, 완료된 비동기 작업에서 연관 레코드를 읽습니다.

  1. 비어 있지 않은 query 하나, location_code, language_code, 0~4 범위의 depth, 1~1,000 범위의 results_limit, 0 이상의 offset을 정합니다.
  2. 페이로드를 /v1/seo/related-keywords로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/seo/related-keywords" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"keyword research","depth":1,"results_limit":100}'

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

Related Keywords API 추천 활용 사례

  • 인접 주제 발굴: 반환된 검색어 텍스트와 연관 관계 맥락을 활용해, 시드 구문을 포함하지 않아도 연결된 주제를 찾습니다.
  • 주제 맵 확장: 깊이와 연관 키워드 경로를 비교해, 시드 하나를 직접 이웃에서 더 넓은 검색어 그래프로 넓혀 갑니다.
  • 후보 키워드 평가: 연관 검색어를 제공되는 수요, 비용, 경쟁도, 난이도, 월별 추이, 검색 의도와 결합해 검토할 수 있는 후보 세트를 준비합니다.

Related Keywords API 활용 팁

  • 직접 연관된 검색어를 보려면 depth 1로 시작하고, 후보가 많아지고 연관성이 느슨해지더라도 더 넓은 그래프가 필요할 때만 depth를 높이세요.
  • 연관 검색어는 표현이 달라질 수 있으므로, 반환되는 모든 검색어에 시드 단어가 포함되어야 한다면 Keyword Suggestions를 대신 사용하세요.
  • 결과 구간을 비교할 때는 연관 관계와 시장 맥락을 같은 기준으로 비교할 수 있도록 query, location_code, language_code, depth를 고정하세요.
  • offset은 페이지 번호가 아니라 행 수로 취급하고, 건너뛰려는 원본 행 수만큼 늘리세요.
  • keyword, metrics, monthly_searches, search_intent는 정규화된 필드에서 먼저 읽고, 원본 깊이와 연관 경로는 extra 필드에서 확인하세요.
  • 그래프상 가깝다는 이유로 검색 의도가 같다고 추정하지 말고, 선택적 측정값과 가변적인 extra 필드는 없을 수 있다고 가정하세요.

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

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

다른 플랫폼 둘러보기

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

Related Keywords API — 자주 묻는 질문

Related Keywords API는 선택한 검색 시장의 연관 검색 그래프를 통해 시드 하나와 이어진 검색어를 찾는 프로그래밍 인터페이스입니다. 키워드 텍스트, 제공되는 측정값, 월별 추이, 검색 의도 정보, 연관 깊이, 원본 행 전체를 반환합니다.

depth는 0~4를 받으며, 0은 제출한 시드 자체, 1은 직접 연관된 검색어, 그보다 큰 값은 재귀적으로 확장한 범위를 뜻합니다. 깊이가 클수록 후보 풀은 넓어지지만 직접적인 연관성은 낮아질 수 있습니다.

아니요. 연관 검색으로 이어진 결과는 표현이 다를 수 있으므로, 구문을 포함하는 롱테일 변형이 필요하다면 Keyword Suggestions를 사용하세요.

정규화된 레코드에는 키워드 텍스트, 검색량, CPC, 광고 경쟁도, 키워드 난이도, 월별 검색량, 검색 의도 정보가 포함될 수 있습니다. 원본 연관 깊이, 연관 경로, keyword_data 객체 전체는 extra 필드에 남아 있습니다.

results_limit은 1~1,000 범위의 상한이고, offset은 건너뛸 이전 원본 행의 수입니다. offset은 페이지 번호가 아니며, 원본에서 요청한 것보다 적은 행이 반환될 수도 있습니다.

반환된 연관 키워드 1개당 0.1 SocQ 크레딧이 차감됩니다. 결과가 비어 있으면 결과 요금이 부과되지 않으며, results_limit은 요청 전 예상치를 정할 뿐 최종 개수를 보장하지는 않습니다.