seo/
relevant-pages

도메인 하나의 색인된 페이지 목록을 조회하고, 페이지 URL, 순위 분포, 모델링된 검색 트래픽, 유료 검색 비용 맥락을 정규화된 레코드로 반환합니다.

Relevant Pages API

페이지 노출 현황
순위 분포
트래픽 추정치
결과당 0.15 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Relevant Pages

연관 페이지는 오가닉 또는 유료 검색에서 측정 가능한 노출이 있는 색인된 URL로, 키워드 수, 순위 구간, 모델링된 트래픽, 비용 추정치, 변동 신호를 포함합니다. 이러한 페이지 단위 측정값은 노출 현황 목록 작성, 노출 규모 비교, 트래픽 가치 검토, 반복 스냅샷 분석에 활용할 수 있습니다.

Relevant Pages API 주요 기능

  • 도메인 단위 페이지 목록선택한 검색 인덱스에서 오가닉 또는 유료 연관성이 측정되는 도메인 하나의 페이지를 절대 URL로 반환합니다.
  • 오가닉 순위 분포순위 구간별 오가닉 키워드 수를 보존하며, 제공되는 경우 신규, 상승, 하락, 이탈한 순위 수도 함께 담습니다.
  • 유료 검색 노출 규모페이지마다 제공되는 유료 키워드 수, 순위 범위, 모델링된 트래픽, 추정 유료 트래픽 비용을 제공합니다.
  • 페이지 지표 객체 전체페이지 URL은 안정적인 식별을 위해 정규화하고, 중첩된 오가닉·유료 지표와 그 밖의 가변적인 페이지 단위 측정값은 extra 필드에 보존합니다.

Relevant Pages API 매개변수

매개변수필수설명
target필수https://와 www.를 뺀 도메인으로, 필수 값입니다. 예: example.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 범위입니다. 실제로는 더 적은 행이 반환될 수 있습니다.
offset선택요청한 결과 구간을 수집하기 전에 건너뛸 원본 행의 수로, 0부터 시작합니다.

Relevant Pages API 사용 방법

올바른 형식의 도메인 하나를 시장 설정, 제한된 원본 구간과 함께 제출하고, 완료된 비동기 작업에서 연관 페이지를 하나씩 읽습니다.

  1. https://와 www.를 뺀 도메인 하나, location_code, language_code, 1~1,000 범위의 results_limit, 0 이상의 offset을 정합니다.
  2. 페이로드를 /v1/seo/relevant-pages로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true인 동안 반환된 next_cursor로 다음 결과를 요청합니다.
curl -X POST "https://api.socq.ai/v1/seo/relevant-pages" \
  -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 true

Relevant Pages API 추천 활용 사례

  • 검색에 노출되는 페이지 목록: 반환된 페이지 URL로, 색인된 검색 연관성이 측정되는 페이지만 담은 도메인 목록을 구성합니다.
  • 오가닉 노출 규모 비교: 오가닉 키워드 수, 순위 구간, 변동 필드를 비교해 페이지별로 노출이 어떻게 분포하는지 파악합니다.
  • 유료 검색 페이지 검토: 유료 키워드 수, 순위 범위, 모델링된 트래픽, 추정 비용을 활용해 반환된 페이지들의 유료 노출 규모를 비교합니다.
  • 페이지 노출 스냅샷: 반복 수집한 레코드를 page_address와 시장별로 저장해, 수집 시점에 따른 순위 분포와 모델링된 트래픽을 비교합니다.

Relevant Pages API 활용 팁

  • 이 엔드포인트는 전체 페이지 URL이 아닌 도메인을 받으므로, 제출하기 전에 target에서 https://와 www.를 제거하세요.
  • 페이지 식별자로는 반환된 url을 사용하세요. text는 같은 URL로 대체된 값이며 페이지 본문 내용은 담지 않습니다.
  • 반복 수집한 결과 구간을 비교할 때는 target, location_code, language_code, results_limit, offset을 고정하세요.
  • offset은 페이지 번호가 아니라 원본 행 수로 취급하고, 작업 결과의 next_cursor와는 별도로 저장하세요.
  • 오가닉·유료 측정값은 extra.metrics에서 읽고, 중첩된 지표 그룹이나 개별 필드는 없을 수 있다고 가정하세요.
  • etv와 estimated_paid_traffic_cost는 비공개 애널리틱스나 실제 수익이 아니라 모델링된 검색 추정치로 해석하세요.

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

  • Google Organic SERP API — 검색어와 시장으로 실시간 Google 검색 결과 페이지 하나를 가져오며, 정규화된 도착 URL, 순위, 요소 유형, 전체 결과 상세를 포함합니다.
  • Keyword Difficulty API — 제출한 키워드 묶음의 오가닉 순위 난이도를 비교하며, 확인 가능한 각 키워드를 정규화된 점수와 함께 반환합니다.
  • Keyword Overview API — 제출한 키워드 묶음에 확인 가능한 수요, 유료 경쟁, 난이도, 월간 검색량, 검색 의도 맥락을 더해 보강합니다.
  • Keyword Search Volume API — 알고 있는 키워드의 검색량, CPC, 유료 경쟁, 월별 검색 추이를 측정합니다.
  • Keywords for Site API — 웹사이트 하나와 관련된 키워드를 생성하며, 확인 가능한 수요 측정값, 월별 추이, 시장 맥락, 전체 원본 행을 포함합니다.
  • Ranked Keywords API — 도메인, 서브도메인, 페이지가 순위에 오른 키워드를 찾으며, 해당 URL, 순위, 검색 측정값, 검색 의도, 전체 원본 요소를 포함합니다.

다른 플랫폼 둘러보기

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

Relevant Pages API — 자주 묻는 질문

Relevant Pages API는 프로토콜과 www 없는 도메인 하나에서, 측정 가능한 검색 연관성이 있는 색인된 페이지를 찾는 프로그래밍 인터페이스입니다. 페이지 URL, 오가닉·유료 순위 분포, 모델링된 트래픽, 비용 추정치, 변동 수, 원본 행 전체를 반환합니다.

https://와 www를 뺀 example.com 같은 도메인 하나를 제출합니다. 페이지 단위로 도메인 목록을 만드는 이 엔드포인트에는 전체 페이지 URL을 제출하지 마세요.

아니요. 검색 인덱스에 등록되어 있고 오가닉 또는 유료 연관성이 측정되는 페이지만 반환하므로, 색인되지 않은 페이지와 측정 가능한 노출이 없는 페이지는 나타나지 않을 수 있습니다.

원본 행에는 오가닉·유료 키워드 수, 순위 구간, 모델링된 트래픽, 추정 유료 트래픽 비용, 순위 변동 수가 포함될 수 있습니다. 이 중첩 값들은 정규화된 최상위 metrics 객체가 아니라 extra.metrics에 남아 있습니다.

아니요. etv와 트래픽 비용 값은 모델링된 검색 추정치이며, 비공개 애널리틱스나 실제 방문 수, 수익 측정값이 아닙니다.

반환된 페이지 1개당 0.15 SocQ 크레딧이 차감됩니다. 결과가 비어 있으면 결과 요금이 부과되지 않으며, results_limit은 요청 전 예상치를 정할 뿐 최종 개수를 보장하지는 않습니다.