Ranktracker API가 출시되었습니다 — 모든 요금제에 이용 권한이 포함되어 있습니다

소개

Ranktracker API가 공식적으로 출시되었습니다.

이제 모든 Ranktracker 요금제에 API 이용 권한이 포함되어, 고객은 Ranktracker를 자신의 대시보드, 리포팅 플랫폼, 내부 시스템 및 SEO 워크플로우와 직접 연동할 수 있습니다.

이제 개발을 시작하기 위해 별도의 API 구독이나 엔터프라이즈 전용 계정이 더 이상 필요하지 않습니다. Launch, Growth, Scale, Authority 중 어떤 요금제를 사용하든 API 키를 생성하여 Ranktracker 계정 내의 데이터를 프로그래밍 방식으로 활용할 수 있습니다.

이 API는 각 요금제에 포함된 키워드, 데이터 행 및 추적 할당량을 기반으로 구축되었습니다. 상위 요금제일수록 더 많은 할당량을 제공하지만, API에 액세스할 수 있는 기능은 모든 요금제 사용자에게 제공됩니다.

다음 링크에서 전체 개발자 문서를 확인해 보세요. developers.ranktracker.com에서 확인하세요.

Ranktracker API를 개발한 이유

SEO 팀들은 단일 플랫폼 외부에서 검색 데이터를 활용할 필요성이 점점 더 커지고 있습니다.

대행사들은 클라이언트 포털 내에서 순위 데이터를 확인하기를 원합니다. 사내 팀들은 순위 데이터를 분석, 리드 및 매출 데이터와 결합하기를 원합니다. 개발자들은 반복적인 프로젝트 관리 작업을 자동화하기를 원합니다. 대규모 조직들은 SEO 데이터를 자체 데이터 웨어하우스 및 비즈니스 인텔리전스 시스템에 저장하기를 원합니다.

수동으로 데이터를 내보내는 방식도 때로는 통할 수 있지만, 수백 개의 도메인이나 수천 개의 키워드에 대해 매일 보고서를 갱신해야 할 때는 비효율적이 됩니다.

Ranktracker API는 귀사의 시스템이 Ranktracker와 직접 통신할 수 있도록 함으로써 이 문제를 해결합니다.

이제 대시보드 내에서 수동으로 동일한 작업을 반복할 필요 없이 순위 데이터를 조회하고, 추적 중인 프로젝트를 관리하며, 키워드를 정리하고, 보고 워크플로를 구축할 수 있습니다.

모든 Ranktracker 요금제에 API 액세스 권한이 포함되어 있습니다

API 사용 권한은 최상위 요금제에만 국한되지 않습니다.

다음 요금제에 포함되어 있습니다:

• 출시
• 성장
• 확장
• 권위

API 사용량은 구독에 포함된 키워드, 데이터 행, 경쟁사 및 기타 할당량 범위 내에서 운영됩니다.

예를 들어, API를 통해 키워드를 추가하는 경우, 해당 키워드는 Ranktracker 인터페이스를 통해 추가된 키워드와 동일한 계정 할당량에 포함됩니다. 대량의 데이터를 가져오기 전에 프로그래밍 방식으로 현재 사용량과 남은 용량을 확인할 수 있습니다.

이를 통해 기업 규모나 기술적 자원에 관계없이 모든 고객이 자동화를 실험해 볼 수 있는 기회를 제공합니다.

소규모 기업은 Ranktracker를 간단한 내부 대시보드에 연동할 수 있습니다. 대행사는 고객 온보딩 및 보고를 자동화할 수 있습니다. 대규모 팀은 Ranktracker 계정을 중심으로 완벽한 데이터 파이프라인을 구축할 수 있습니다.

전체 상위 100개 순위 데이터

Ranktracker는 완전한 상위 100개 순위 추적을 기반으로 구축되었습니다.

Ranktracker는 Google의 첫 페이지에서 멈추지 않고, 자연 검색 결과의 10페이지 전체를 추적합니다. 이를 통해 1페이지에 도달하기 전에 노출이 증가하기 시작하는 키워드를 파악할 수 있습니다.

API를 통해 추적 중인 키워드에 대한 최신 순위 이력을 조회할 수 있으며, 여기에는 다음과 같은 정보가 포함됩니다:

• 현재 자연 검색 순위
• SERP 절대 순위
• 순위 URL
• 일일 순위 변동
• 주간 순위 변동
• 월간 순위 변동
• 검색량
• 예상 트래픽
• 클릭당 비용
• 경쟁도
• 키워드 난이도

또한 모든 추적 대상 키워드는 설정된 검색 엔진, 지역, 언어 및 기기와 연결될 수 있습니다. 이를 통해 팀은 단순한 키워드 순위 목록보다 훨씬 더 상세한 보고서를 작성할 수 있습니다.

107,000개 이상의 지역에서 추적

Ranktracker는 107,000개 이상의 추적 가능한 지역을 지원하며, 데스크톱 및 모바일 추적 기능과 광범위한 언어 지원도 제공합니다. 덕분에 이 API는 다음과 같은 용도에 적합합니다:

• 지역 SEO 캠페인
• 전국 검색 모니터링
• 국제 SEO
• 다국어 웹사이트
• 프랜차이즈 및 다중 지점 사업
• 다양한 시장에서 고객을 관리하는 대행사

키워드는 지역, 언어, 기기의 다양한 조합에 걸쳐 추적할 수 있습니다.

예를 들어, 대행사는 런던, 맨체스터, 버밍엄에서 데스크톱과 모바일 모두에 걸쳐 동일한 키워드를 추적할 수 있습니다. 각 조합은 별도의 추적 행으로 저장되므로, 대행사는 시장별로 검색 성과가 어떻게 다른지 더 정확하게 파악할 수 있습니다.

Ranktracker API로 할 수 있는 일

이 API를 통해 Ranktracker 계정에서 사용되는 주요 리소스에 접근할 수 있습니다.

도메인 관리

프로그래밍 방식으로 추적 대상 도메인을 생성, 조회, 업데이트 및 삭제할 수 있습니다.

이를 통해 Ranktracker를 고객 온보딩 프로세스에 연결할 수 있습니다. 내부 시스템에 클라이언트가 추가되면 Ranktracker 내에서도 해당 도메인이 자동으로 생성될 수 있습니다.

도메인 수준의 엔드포인트는 또한 선택한 기간 동안의 순위 이력 및 점유율 데이터를 제공합니다. 이력 및 점유율 요청은 최대 365일까지의 기간을 다룰 수 있으며, 데스크톱, 모바일 또는 모든 기기로 필터링할 수 있습니다. 경쟁사 관리

추적 중인 각 도메인과 관련된 경쟁사를 추가, 조회, 업데이트 또는 제거할 수 있습니다.

이 기능을 통해 신규 프로젝트에 대한 경쟁사 모니터링을 자동으로 설정하거나, Ranktracker와 다른 플랫폼 간에 고객 설정을 동기화할 수 있습니다.

키워드 추가 및 관리

도메인에 대해 추적할 키워드를 생성하고, 해당 키워드의 검색 엔진, 위치, 언어, 기기 및 추적 빈도를 지정할 수 있습니다.

이 API는 키워드 구문과 검색 엔진 설정을 조합하여 일괄 생성하는 기능을 지원합니다. 수백 건의 개별 요청을 보내는 대신, 여러 단어와 추적 설정을 한꺼번에 제출할 수 있습니다. 키워드 스트링은 프로그래밍 방식으로 일시 중지, 재개 또는 제거할 수도 있습니다.

순위 기록 조회

도메인에 연결된 모든 키워드의 최신 순위 결과를 가져옵니다.

이 데이터는 다음으로 전송할 수 있습니다:

• 고객 보고 포털
• Google 스프레드시트
• 데이터 웨어하우스
• 비즈니스 인텔리전스 대시보드
• 내부 알림 시스템
• 맞춤형 SEO 애플리케이션

문서에는 일일 순위를 추출하여 데이터 웨어하우스나 CSV 기반 워크플로우로 불러오는 방법에 대한 완전한 튜토리얼이 포함되어 있습니다. SERP 결과 액세스

추적 중인 각 키워드에 대해 최신 분석된 검색 결과에 액세스할 수 있습니다.

여기에는 자연 검색 결과와 이를 둘러싼 SERP 기능이 포함됩니다. Ranktracker는 추천 스니펫, 지도 결과, 동영상, 쇼핑 결과, ‘사람들이 자주 묻는 질문’ 결과 및 AI 개요와 같은 기능을 추적합니다. 지원되는 추적 키워드의 경우 캐시된 SERP HTML도 이용할 수 있습니다. 이를 통해 도메인의 수치적 순위 이상의 정보를 분석할 수 있습니다.

또한 어떤 유형의 검색 결과가 표시되는지, 귀사의 목록을 둘러싼 경쟁사는 어디인지, 그리고 어떤 SERP 기능이 자연 검색 클릭률에 영향을 미칠 수 있는지 파악할 수 있습니다.

목소리 점유율(Share-of-Voice) 보고서 생성

‘셰어 오브 보이스(Share-of-Voice)’ 엔드포인트는 전반적인 가시성 수치, 선택한 기간 동안의 변화, 그리고 귀사의 도메인과 추적 대상 경쟁사를 비교한 일별 시계열 데이터를 반환합니다.

이 데이터는 차트 및 보고서를 위해 이미 구조화되어 있습니다. 이를 활용하여 귀사의 브랜드가 경쟁 도메인에 비해 입지를 확대하고 있는지, 아니면 축소하고 있는지를 보여주는 가시성 추세를 생성할 수 있습니다. 태그를 사용하여 키워드 정리

계정 수준의 태그를 생성하고 여러 프로젝트에 걸쳐 키워드에 적용하세요.

태그는 다음을 구분하는 데 사용할 수 있습니다:

• 브랜드 키워드 및 비브랜드 키워드
• 제품 및 서비스
• 국가 또는 지역
• 캠페인
• 우선순위 키워드
• 고객 보고 그룹
• 웹사이트의 다양한 영역

이 API는 일괄 태그 지정을 지원하므로, 단일 요청으로 여러 키워드에 하나의 태그를 적용할 수 있습니다. 계정 사용량 모니터링

계정 사용량 엔드포인트는 요금제 중 얼마나 사용되었는지, 그리고 남은 용량이 얼마나 되는지 보여줍니다.

다음과 같은 할당량을 보고합니다:

• 활성 키워드
• 데이터 행
• 주문형 점검
• SERP 분석기 크레딧

각 할당량에는 현재 사용량, 총 한도 및 남은 용량이 포함됩니다. 이는 대용량 키워드 목록을 가져오기 전에 특히 유용합니다. 통합 솔루션에서 먼저 사용 가능한 용량을 확인하여 계정의 할당량을 초과하는 가져오기 시도를 방지할 수 있습니다.

대행사 전용

대행사들은 새로운 API의 혜택을 누릴 수 있는 주요 그룹 중 하나입니다.

일반적인 자동화된 온보딩 워크플로는 다음과 같을 수 있습니다:

1. 클라이언트의 도메인을 생성합니다.
2. 경쟁사를 추가하세요.
3. 타겟 키워드를 가져옵니다.
4. 위치, 언어 및 기기를 설정합니다.
5. 고객사별 태그를 생성합니다.
6. 순위 데이터를 내부 대시보드로 전송합니다.
7. 정기적인 노출 보고서를 생성합니다.

이전에는 여러 단계의 수작업이 필요했던 프로세스를 이제 대행사 자체의 프로젝트 관리 시스템이나 고객 온보딩 시스템과 연동할 수 있습니다.

대행사들은 또한 일일 순위 스냅샷을 자체 데이터베이스로 가져와 화이트 라벨 포털 내에서 해당 정보를 제공할 수 있습니다.

사내 SEO 팀을 위해 설계됨

사내 팀은 순위 데이터를 더 광범위한 비즈니스 데이터와 연계할 수 있습니다.

예를 들어, 키워드 성과는 다음과 같은 요소들과 결합될 수 있습니다:

• Google Search Console 클릭 수
• 웹사이트 전환
• 전자상거래 매출
• 생성된 리드
• 랜딩 페이지 성과
• 콘텐츠 게시 날짜
• 기술적 SEO 업데이트

이를 통해 단편적인 순위 보고서를 넘어, 검색 가시성이 더 광범위한 비즈니스 성과에 어떻게 기여하는지 이해하기가 더 쉬워집니다.

SEO 플랫폼 및 개발자를 위해 설계됨

개발자는 Ranktracker를 내부 도구 또는 고객용 애플리케이션의 기반이 되는 순위 및 SERP 데이터 레이어로 활용할 수 있습니다.

이 API는 일관된 REST 구조를 따르며, 모든 프로덕션 엔드포인트는 다음을 사용합니다:

https://api.ranktracker.com/v1

응답은 JSON:API 스타일 형식을 사용합니다. 리소스는 data 아래에 반환되며, 해당 필드는 attributes 객체 내에 포함됩니다. 목록 엔드포인트는 페이지당 최대 1,000개의 레코드에 대한 페이지네이션을 지원하며, 응답 헤더를 통해 총 개수를 반환합니다. 문서에는 현재 다음 항목에 대한 실제 예제가 제공됩니다:

• cURL
• Python
• Node.js

또한 도메인 생성, 키워드 추적, 데이터 웨어하우스 내보내기, 점유율(Share-of-Voice) 보고 및 대량 키워드 태깅을 다루는 완전한 튜토리얼도 포함되어 있습니다.

API 키 생성 방법

시작하는 데는 몇 단계만 거치면 됩니다:

1. Ranktracker 계정에 로그인하세요.
2. 계정 설정을 엽니다.
3. API 키 섹션으로 이동하세요.
4. 새 API 키를 생성하세요.
5. 서버에 키를 안전하게 저장하십시오.

API 키 형식은 다음과 같습니다:

tkn_usr_...

키를 Authorization 헤더에 직접 전달해야 합니다. Bearer 접두사는 필요하지 않습니다. 다음은 계정에 등록된 도메인을 나열하는 기본 요청 예시입니다:

요청이 성공하면 해당 키에 연결된 계정이 소유한 도메인이 반환됩니다.

API 키는 항상 비밀번호처럼 취급해야 합니다. 공개 저장소, 브라우저 코드 또는 모바일 애플리케이션에 저장해서는 안 됩니다.

신뢰할 수 있는 자동화를 위해 설계됨

이 API는 표준 HTTP 메서드와 예측 가능한 응답 구조를 사용합니다.

다음 기능을 지원합니다:

• 리소스 검색을 위한GET
• 리소스 생성을 위한POST
• PATCH: 리소스 업데이트
• 리소스를 삭제하려면DELETE를 사용합니다.

오류에는 기계가 읽을 수 있는 코드와 설명이 포함되어 있어, 통합 시스템에서 요청을 수정해야 하는지, 계정의 허용 한도에 도달했는지, 또는 일시적인 요청을 재시도해야 하는지 판단할 수 있습니다. k 작업, 페이지 분할 및 사용량 보고 기능은 대규모 프로젝트를 관리할 때 불필요한 요청을 줄이는 데도 도움이 됩니다.

MCP에 대한 간략한 설명

Ranktracker는 지원되는 AI 도구 및 어시스턴트를 Ranktracker 데이터에 연결할 수 있는 MCP 서버 옵션도 제공합니다.

MCP 서버, 지원되는 도구 및 연결 절차에 대해서는 별도의 기사에서 다룰 예정입니다.

Ranktracker API로 개발을 시작하세요

Ranktracker API를 통해 SEO 전문가들은 검색 데이터를 수집, 정리 및 활용하는 방식을 보다 유연하게 제어할 수 있습니다.

순위 추적 워크플로를 자동화하고, 프로젝트를 동기화하며, 전체 상위 100개 검색 결과를 가져오고, SERP 기능을 분석하고, 시장 점유율을 비교하며, 조직에서 이미 사용 중인 시스템에 SEO 데이터를 연동할 수 있습니다.

가장 중요한 점은 이제 모든 Ranktracker 요금제에 API 액세스 권한이 포함되어 있다는 것입니다.

Ranktracker 계정에서 API 키를 생성하고 다음 주소에서 문서를 확인해 보세요. developers.ranktracker.com에서 문서를 확인해 보세요.