Domain Overview
도메인의 검색 존재감은 국가와 언어 하나를 기준으로 한 Google 검색 결과 노출로, 순위에 오른 키워드 수, 그 순위가 가져올 것으로 추정되는 월간 방문 수, 그 트래픽을 광고로 샀을 때의 비용으로 요약되며 오가닉과 유료로 나뉘고 1~100위 순위 구간과 신규·상승·하락·이탈 순위 수로 펼쳐집니다. 이 총계 한 행으로 경쟁사의 규모를 가늠하고 검색 노출로 잠재 고객을 선별할 수 있으며, 매달 저장하면 자사 사이트의 노출 추이를 추적할 수 있습니다.
Domain Overview API 주요 기능
- Google 시장 하나의 도메인 하나target 값에는 도메인을 넣고 location과 language 값으로 검색 결과의 국가와 언어를 고르며(기본값은 미국과 영어), 행마다 location_code와 language_code 값이 함께 담겨 저장한 스냅숏의 기준이 남습니다.
- 같은 구조의 오가닉과 유료organic과 paid 값은 같은 총계 항목을 갖고 있어 무료 순위와 검색 광고를 필드 단위로 비교할 수 있습니다.
- 광고 가치로 환산한 트래픽keywords_count 값은 순위 키워드 수, estimated_traffic 값은 그 키워드가 가져오는 월간 방문 수, estimated_traffic_cost 값은 그 트래픽을 Google Ads 단가로 환산한 미국 달러 금액입니다.
- 12개 순위 구간positions 값은 순위 키워드를 pos_1, pos_2_3, pos_4_10부터 pos_91_100까지의 구간으로 나눠, 도메인이 1페이지를 차지하는지 더 뒤쪽에 머무는지 보여 줍니다.
- 지난 업데이트 이후 순위 변동new_count, up_count, down_count, lost_count 값은 이전 데이터 업데이트 이후 순위에 새로 들어오거나, 오르거나, 내려가거나, 빠진 키워드 수를 알려 줍니다.
Domain Overview API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
target | 필수 | 분석할 도메인이나 서브도메인으로 notion.so 같은 값입니다. https://와 www.는 제거되며, 경로가 포함된 URL은 거부됩니다. |
location_code | 선택 | 검색 국가의 숫자 코드로, 기본값인 미국은 2840입니다. 이 값이나 location_name 중 하나를 사용하세요. |
location_name | 선택 | location_code 대신 쓰는 United States 같은 국가 이름입니다. 둘 다 보내면 같은 국가를 가리켜야 합니다. |
language_code | 선택 | en(기본값) 같은 언어 코드로, 선택한 국가에서 제공되는 언어 중 하나여야 합니다. |
language | 선택 | language_code 대신 쓰는 English 같은 언어 이름입니다. 둘 다 보내면 서로 일치해야 합니다. |
Domain Overview API 사용 방법
도메인과 시장을 보내고 작업이 끝나면 개요 행을 읽습니다.
- {"target": "notion.so", "location_code": 2840, "language_code": "en"}을 /v1/seo/domain-overview로 POST합니다.
- GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
- results.items에서 개요 행 하나를 읽습니다. results.next_cursor는 has_more 값이 true일 때만 필요합니다.
curl -X POST "https://api.socq.ai/v1/seo/domain-overview" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"notion.so","location_code":2840,"language_code":"en"}'
# One market per request, 5 credits.Domain Overview API 추천 활용 사례
- 경쟁사 검색 존재감 측정: organic.keywords_count와 organic.estimated_traffic 값을 읽어 경쟁사가 Google로 이미 시장을 얼마나 확보했는지 확인합니다.
- 자사 노출의 월별 추적: 매달 positions 구간과 신규·상승·하락·이탈 수를 저장해 순위가 1페이지 쪽으로 올라가고 있는지 차트로 확인합니다.
- 에이전시 잠재 고객 선별: 어떤 고객사를 공략할지 정할 때 organic.estimated_traffic_cost 값을 잠재 고객 검색 트래픽의 달러 가치로 활용합니다.
- 검색 광고 집행 여부 확인: paid.keywords_count와 paid.estimated_traffic 값으로 도메인이 해당 시장에서 Google 검색 광고를 집행하는지, 광고로 얼마나 트래픽을 얻는지 확인합니다.
- 국가별 같은 사이트 비교: 같은 도메인을 location과 language 설정만 바꿔 제출해 어느 시장에서 가장 강한지 확인합니다.
Domain Overview API 활용 팁
- 영어가 제공되지 않는 국가라면 language_code나 language 값을 직접 지정하세요. 기본값 en은 그 국가가 영어를 지원할 때만 허용됩니다.
- 1페이지 키워드 수가 필요하면 pos_1, pos_2_3, pos_4_10 값을 더하세요. 각 구간은 서로 겹치지 않는 별도 범위입니다.
- 신규·상승·하락·이탈 수는 마지막 요청이 아니라 이전 데이터 업데이트 이후의 변화로 읽고, 행마다 collected_at 값과 함께 저장해 자체 이력을 쌓으세요.
- 도메인은 순수 도메인으로 보내세요. 사이트의 개별 페이지 수치가 필요하면 페이지별 순위 분포를 제공하는 Relevant Pages API를 사용합니다.
관련 API
Domain Overview API 외에 SEO의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Google Organic SERP API — 검색어와 시장으로 실시간 Google 검색 결과 페이지 하나를 가져오며, 정규화된 도착 URL, 순위, 요소 유형, 전체 결과 상세를 포함합니다.
- Keyword Difficulty API — 제출한 키워드 묶음의 오가닉 순위 난이도를 비교하며, 확인 가능한 각 키워드를 정규화된 점수와 함께 반환합니다.
- Keyword Overview API — 제출한 키워드 묶음에 확인 가능한 수요, 유료 경쟁, 난이도, 월간 검색량, 검색 의도 맥락을 더해 보강합니다.
- Ranked Keywords API — 도메인, 서브도메인, 페이지가 순위에 오른 키워드를 찾으며, 해당 URL, 순위, 검색 측정값, 검색 의도, 전체 원본 요소를 포함합니다.
- Competitor Domains API — 한 시장에서 사이트와 같은 Google 키워드로 순위에 오른 도메인을 찾으며 공유 키워드 수, 평균 순위, 겹치는 트래픽, 전체 검색 총계를 포함합니다.
- Traffic Estimate API — 한 시장에서 최대 1,000개 도메인의 월간 Google 오가닉·유료 검색 방문 수와 키워드 수를 추정합니다.
- Keyword Search Volume API
- Keywords for Site API
- Keyword Suggestions API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API