Keywords for Site
Keywords for Site 레코드는 웹사이트의 주제를 관련 검색어, 검색량, CPC, 광고 경쟁도, 월별 수요, 카테고리 맥락과 연결합니다. 이러한 키워드와 지표의 관계는 주제 발굴, 경쟁사 조사, 후보 목록 구성, 도메인 간 비교에 활용할 수 있습니다.
Keywords for Site API 주요 기능
- 도메인 기반 연관 키워드 발굴시드 키워드에서 시작하지 않고, 웹사이트 도메인 하나로 해당 사이트의 주제와 연관된 키워드 아이디어를 가져옵니다.
- 수요 및 유료 검색 지표반환된 키워드마다 정규화된 검색량, CPC, 광고 경쟁도, 경쟁 수준, 월별 검색 추이로 평가합니다.
- 키워드 전체 맥락extra 필드에서 반환된 행 전체를 확인할 수 있으며, 선택적인 카테고리, 난이도, 검색 의도, 트렌드 필드 등 별도로 정규화되지 않은 속성도 여기에 남아 있습니다.
Keywords for Site API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
target | 필수 | 주제의 기준이 되는 웹사이트 도메인으로, 필수 값입니다. 플레이그라운드의 기본값은 microsoft.com입니다. |
location_code | 선택 | 검색 시장의 지역을 나타내는 양수 코드로, 선택 값입니다. 플레이그라운드는 기본으로 2840을 제출합니다. |
location_name | 선택 | location_code 대신 쓸 수 있는 검색 시장 이름으로, 선택 값입니다. 입력하면 location_code보다 우선합니다. |
language_code | 선택 | 2~10자의 검색 언어 코드로, 선택 값입니다. 플레이그라운드는 기본으로 en을 제출합니다. |
language | 선택 | language_code 대신 쓸 수 있는 검색 언어 이름으로, 선택 값입니다. 입력하면 language_code보다 우선합니다. |
results_limit | 선택 | 원본에서 가져올 결과 수의 상한으로, 1~1,000 범위입니다. 플레이그라운드는 문서 예시에 맞춰 5를 제출하며, 생략하면 백엔드는 100을 사용합니다. |
Keywords for Site API 사용 방법
도메인 하나와 시장, 언어, 결과 수 제한을 설정해 제출하고, 완료된 작업에서 정규화된 키워드 레코드를 읽습니다.
- 도메인 target 하나, 양수인 location_code, language_code, 1~1,000 범위의 results_limit을 정합니다.
- 페이로드를 /v1/seo/keywords-for-site로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- data.results.items를 읽고, has_more가 true인 동안 next_cursor를 따라 다음 결과를 가져옵니다.
curl -X POST "https://api.socq.ai/v1/seo/keywords-for-site" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueKeywords for Site API 추천 활용 사례
- 웹사이트 주제 발굴: 반환된 키워드와 카테고리를 활용해 알고 있는 웹사이트와 연관된 검색 주제를 파악합니다.
- 경쟁사 키워드 조사: 경쟁사 도메인을 제출하고, 관련 검색어를 검색량, CPC, 광고 경쟁도와 함께 모아 조사용 키워드 세트를 구성합니다.
- 도메인 간 주제 비교: 웹사이트 대상을 각각 따로 실행해 반환된 키워드 세트, 카테고리, 수요 지표를 서로 비교합니다.
Keywords for Site API 활용 팁
- target 형식 오류를 피하려면 도메인을 제출하기 전에 http://와 https://를 제거하세요.
- 실행 결과를 비교할 때는 생략된 필드에 대한 제공처의 기본 동작에 기대지 말고, 시장과 언어를 명시적으로 지정하세요.
- 이 엔드포인트에는 이후 구간의 결과를 요청할 offset이 없으므로, results_limit은 한 번에 받을 수 있는 가장 유용한 최대치로 정하세요.
- 누락된 지표는 0이 아니라 알 수 없는 값으로 취급하고, 정규화된 필드에 필요한 속성이 없으면 extra 필드를 확인하세요.
- 관련도 기반 키워드 아이디어가 아니라 실제 관측된 순위나 순위 URL이 필요하다면 Ranked Keywords를 대신 사용하세요.
관련 API
Keywords for Site API 외에 SEO의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Google Organic SERP API — 검색어와 시장으로 실시간 Google 검색 결과 페이지 하나를 가져오며, 정규화된 도착 URL, 순위, 요소 유형, 전체 결과 상세를 포함합니다.
- Keyword Difficulty API — 제출한 키워드 묶음의 오가닉 순위 난이도를 비교하며, 확인 가능한 각 키워드를 정규화된 점수와 함께 반환합니다.
- Keyword Overview API — 제출한 키워드 묶음에 확인 가능한 수요, 유료 경쟁, 난이도, 월간 검색량, 검색 의도 맥락을 더해 보강합니다.
- Keyword Search Volume API — 알고 있는 키워드의 검색량, CPC, 유료 경쟁, 월별 검색 추이를 측정합니다.
- Ranked Keywords API — 도메인, 서브도메인, 페이지가 순위에 오른 키워드를 찾으며, 해당 URL, 순위, 검색 측정값, 검색 의도, 전체 원본 요소를 포함합니다.
- Relevant Pages API — 도메인 하나의 색인된 페이지를 목록화하며, 오가닉 및 유료 순위 분포, 추정 트래픽, 예상 비용 맥락을 포함합니다.
- Keyword Suggestions API
- Related Keywords API
- Search Intent 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