seo/
traffic-estimate

요청 하나로 최대 1,000개 도메인의 Google 검색 트래픽을 추정하며, 도메인마다 월간 오가닉·유료 방문 수와 오가닉·유료 키워드 수를 반환합니다.

Traffic Estimate API

최대 1,000개 도메인
오가닉·유료 방문 수
도메인당 한 행
요청당 3 크레딧 + 도메인당 0.1 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Traffic Estimate

검색 트래픽 추정치는 특정 국가와 언어의 Google 검색 결과에서 웹사이트가 받는 월간 방문 수를 수치로 나타낸 것으로, 사이트가 순위에 오른 키워드 수와 함께한 오가닉 방문, 광고하는 키워드 수와 함께한 유료 방문으로 나뉩니다. 수백 개 도메인에 걸쳐 이 네 가지 수치를 나란히 놓으면 잠재 고객·파트너 목록을 규모순으로 정렬하고, 계정 정보를 보강하고, 한 카테고리의 경쟁사 전체를 한눈에 비교할 수 있습니다.

Traffic Estimate API 주요 기능

  • 요청 하나에 최대 1,000개 도메인targets 배열에는 도메인을 최대 1,000개까지 넣을 수 있고, 각 도메인은 domain 값을 키로 한 별도 행으로 반환됩니다.
  • 도메인마다 네 가지 수치organic_traffic과 organic_keywords_count 값은 무료 검색 방문과 순위 키워드를, paid_traffic과 paid_keywords_count 값은 검색 광고에서 오는 방문과 키워드를 측정합니다.
  • 배치 전체에 적용되는 시장 하나location과 language 매개변수가 목록의 모든 도메인에 적용될 Google 국가와 언어를 정하며, 기본값은 미국과 영어입니다.

Traffic Estimate API 매개변수

매개변수필수설명
targets필수트래픽을 추정할 도메인 최대 1000개로 notion.so나 figma.com 같은 값을 한 줄에 하나씩 또는 쉼표로 구분해 넣습니다. https://와 www.는 제거됩니다.
location_code선택목록의 모든 도메인에 적용되는 Google 국가 숫자 코드로, 기본값은 미국인 2840입니다. 이 값이나 location_name 중 하나를 사용하세요.
location_name선택location_code 대신 쓰는 United States 같은 국가 이름입니다. 둘 다 보내면 같은 국가를 가리켜야 합니다.
language_code선택검색 시장의 언어 코드로 기본값은 en이며, 선택한 국가에서 제공되는 언어여야 합니다.
language선택language_code 대신 쓰는 English 같은 언어 이름입니다. 둘 다 보내면 서로 일치해야 합니다.

Traffic Estimate API 사용 방법

도메인 목록과 시장을 제출하고 도메인마다 트래픽 행 하나를 읽습니다.

  1. {"targets": ["notion.so", "figma.com", "canva.com"], "location_code": 2840, "language_code": "en"}을 /v1/seo/traffic-estimate로 POST합니다.
  2. GET /v1/tasks/{task_id}를 폴링해 status 값이 succeeded가 될 때까지 기다립니다.
  3. results.items에서 행을 읽고, has_more 값이 true인 동안 results.next_cursor를 따라갑니다. 도메인 목록이 길면 이 단계가 필요합니다.
curl -X POST "https://api.socq.ai/v1/seo/traffic-estimate" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"targets":["notion.so","figma.com","canva.com"],"location_code":2840,"language_code":"en"}'

# 3 credits per request plus 0.1 per domain in targets.

Traffic Estimate API 추천 활용 사례

  • 검색 트래픽 기준 잠재 고객 순위: 영업 목록이나 제휴 목록을 제출하고 organic_traffic 값으로 정렬해 검색 오디언스가 가장 큰 사이트를 맨 위에 둡니다.
  • CRM 계정 정보 보강: 각 계정의 웹사이트 필드에 organic_traffic과 organic_keywords_count 값을 기록해 영업 담당자가 검색 규모로 계정을 세분화할 수 있게 합니다.
  • 카테고리 전체 벤치마킹: 한 시장의 모든 브랜드를 한 번에 추정하고 organic_traffic과 organic_keywords_count 값을 비교해 그 카테고리의 검색을 누가 주도하는지 확인합니다.
  • 목록 속 검색 광고주 찾기: paid_keywords_count 값이 0보다 큰 행을 걸러 paid_traffic 값으로 순위를 매기면, 이미 Google 검색 광고를 집행하는 도메인을 찾을 수 있습니다.

Traffic Estimate API 활용 팁

  • 보내기 전에 목록을 정리하세요. 순수 도메인이나 사이트 루트만 넣어야 하며, 경로가 있거나 잘못된 이름이 하나라도 섞이면 요청 전체가 거부됩니다.
  • example.com과 www.example.com 같은 중복은 제출 전에 지우세요. 결과는 한 행으로 합쳐지지만, 목록에 넣은 항목은 모두 도메인당 요금에 포함됩니다.
  • 행이 targets 값과 다른 순서로 반환될 수 있으므로, 결과는 위치가 아니라 domain 필드로 원래 목록과 결합하세요.
  • location과 language 값은 요청 안의 모든 도메인에 적용되므로, 국가가 섞인 목록은 시장별로 나눠 요청을 따로 보내세요.
  • 순위 구간, 트래픽 가치, 순위 변동까지 필요한 최종 후보는 도메인마다 Domain Overview API로 이어서 확인하세요.

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

  • Google Organic SERP API — 검색어와 시장으로 실시간 Google 검색 결과 페이지 하나를 가져오며, 정규화된 도착 URL, 순위, 요소 유형, 전체 결과 상세를 포함합니다.
  • Keyword Difficulty API — 제출한 키워드 묶음의 오가닉 순위 난이도를 비교하며, 확인 가능한 각 키워드를 정규화된 점수와 함께 반환합니다.
  • Keyword Overview API — 제출한 키워드 묶음에 확인 가능한 수요, 유료 경쟁, 난이도, 월간 검색량, 검색 의도 맥락을 더해 보강합니다.
  • Domain Overview API — 선택한 국가와 언어에서 도메인 하나의 오가닉·유료 Google 총계를 가져오며 순위 키워드, 추정 트래픽과 광고 비용, 순위 구간, 순위 변동을 포함합니다.
  • Competitor Domains API — 한 시장에서 사이트와 같은 Google 키워드로 순위에 오른 도메인을 찾으며 공유 키워드 수, 평균 순위, 겹치는 트래픽, 전체 검색 총계를 포함합니다.
  • Domain Technologies API — 도메인으로 웹사이트가 쓰는 기술을 카테고리와 함께 감지하고 권위 순위, 소셜 프로필, 공개 연락처를 반환합니다.

다른 플랫폼 둘러보기

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

Traffic Estimate API — 자주 묻는 질문

Traffic Estimate API는 국가와 언어 하나를 기준으로 최대 1,000개 도메인의 Google 검색 트래픽을 한 번에 추정하는 프로그래밍 인터페이스입니다. 도메인마다 월간 오가닉·유료 추정 방문 수와 오가닉·유료 키워드 수를 반환합니다.

검색 트래픽 기준으로 사용할 수 있습니다. organic_traffic과 paid_traffic 값은 선택한 시장에서 각 도메인이 Google 오가닉 결과와 검색 광고로 받는 월간 방문 수를 추정합니다.

targets 배열에 최대 1,000개까지 넣을 수 있습니다. 더 큰 목록은 여러 요청으로 나누면 되며, 요청마다 따로 청구됩니다.

요청 한 번에 3 크레딧에 targets의 도메인 하나당 0.1 크레딧이 더해지므로, 도메인 100개는 13 크레딧, 1,000개는 103 크레딧입니다.