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 사용 방법
시드 검색어 하나를 연관 깊이, 시장 설정, 제한된 결과 구간과 함께 제출하고, 완료된 비동기 작업에서 연관 레코드를 읽습니다.
- 비어 있지 않은 query 하나, location_code, language_code, 0~4 범위의 depth, 1~1,000 범위의 results_limit, 0 이상의 offset을 정합니다.
- 페이로드를 /v1/seo/related-keywords로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 trueRelated 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 필드는 없을 수 있다고 가정하세요.
관련 API
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 — 제출한 키워드 묶음의 주요 및 보조 검색 의도를 분류하며, 원본 확률값과 전체 레코드를 유지합니다.
- Keywords for Site API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API