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 사용 방법
올바른 형식의 도메인 하나를 시장 설정, 제한된 원본 구간과 함께 제출하고, 완료된 비동기 작업에서 연관 페이지를 하나씩 읽습니다.
- https://와 www.를 뺀 도메인 하나, location_code, language_code, 1~1,000 범위의 results_limit, 0 이상의 offset을 정합니다.
- 페이로드를 /v1/seo/relevant-pages로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 trueRelevant 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는 비공개 애널리틱스나 실제 수익이 아니라 모델링된 검색 추정치로 해석하세요.
관련 API
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, 순위, 검색 측정값, 검색 의도, 전체 원본 요소를 포함합니다.
- 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