seo/
domain-overview

국가와 언어 하나를 기준으로 도메인의 오가닉·유료 Google 검색 총계를 가져오며, 순위 키워드, 월간 트래픽과 광고 비용, 순위 구간, 순위 변동을 반환합니다.

Domain Overview API

오가닉·유료 총계
1~100 순위 구간
국가·언어별 시장
요청당 5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

도메인과 시장을 보내고 작업이 끝나면 개요 행을 읽습니다.

  1. {"target": "notion.so", "location_code": 2840, "language_code": "en"}을 /v1/seo/domain-overview로 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
  3. 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를 사용합니다.

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 오가닉·유료 검색 방문 수와 키워드 수를 추정합니다.

다른 플랫폼 둘러보기

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

Domain Overview API — 자주 묻는 질문

Domain Overview API는 선택한 국가와 언어 하나를 기준으로 도메인의 Google 검색 총계를 읽어 오는 프로그래밍 인터페이스입니다. 오가닉·유료 키워드 수, 월간 추정 트래픽과 광고 비용, 순위 구간별 분포, 신규·상승·하락·이탈 키워드 수를 반환합니다.

검색 트래픽을 확인합니다. estimated_traffic 값은 선택한 시장의 Google 검색 결과에서 도메인이 받을 것으로 추정되는 월간 방문 수이며, 오가닉과 유료 결과로 나뉘어 제공됩니다.

국가는 location_code나 location_name 값으로, 언어는 language_code나 language 값으로 지정하며 언어는 그 국가에서 제공되는 것이어야 합니다. 지정하지 않으면 미국과 영어가 적용됩니다.

같은 트래픽을 Google Ads로 샀을 때 드는 월간 추정 비용을 미국 달러로 나타낸 값으로, 오가닉 노출을 비교 가능한 금액으로 바꿔 줍니다.

요청마다 도메인 하나를 다룹니다. 긴 목록의 트래픽과 키워드 수를 비교하려면 도메인을 한 번에 최대 1,000개까지 받는 Traffic Estimate API를 사용하세요.

시장 하나의 도메인 하나를 다루는 요청마다 5 크레딧이 고정으로 청구됩니다.