소개

Ahrefs API를 사용하면 Ahrefs 작업 공간의 데이터를 활용해 사용자 정의 통합 및 자동화를 만들 수 있습니다. 현재 API v3를 사용하면 사이트 익스플로러, 키워드 익스플로러, SERP 개요, 순위 트래커, 사이트 감사, 브랜드 레이더, 소셜 미디어 관리 엔드포인트에서 데이터를 가져올 수 있으며, 순위 트래커 프로젝트와 키워드 익스플로러 목록도 관리할 수 있습니다:

• 사이트 익스플로러: 개요 통계 및 과거 차트, 백링크, 유기적 및 유료 트래픽 보고서
• 키워드 익스플로러: 단일 키워드 또는 키워드 목록의 지표, 검색량 추이 및 국가별 검색량, 키워드 아이디어 보고서
• 사이트 감사: 프로젝트 건강 점수, 전체 이슈 보고서 및 크롤링된 페이지 콘텐츠
• SERP 개요: 상위 100개 SERP 결과
• 순위 트래커: 프로젝트 개요, 경쟁사 보고서 및 순위 트래커 SERP
• 일괄 분석: 요청당 최대 100개 대상의 지표
• 브랜드 레이더: 브랜드 개요 통계, 과거 성과 차트, 그리고 여러 AI 에이전트에 걸친 출처가 포함된 실제 프롬프트
• 소셜 미디어 관리: 연결된 소셜 미디어 계정의 채널, 게시물, 활동 내역 및 지표
• 관리: 순위 트래커 프로젝트 및 키워드 익스플로러 목록을 관리하기 위한 엔드포인트
• 구독 정보: API 제한 및 사용량
• 공개 엔드포인트: 당사 크롤러의 IP 주소 및 범위

이용 자격

Ahrefs API는 자격이 있는 유료 요금제에서 이용할 수 있습니다. 그 외 모든 요금제에서도 제한된 수의 무료 테스트 쿼리는 계속 사용할 수 있습니다.

요금제 한도

무료 테스트 쿼리와 순위 트래커, 관리, 공개 및 일부 다른 엔드포인트를 제외한 모든 요청은 API 유닛을 소비합니다. 비용은 응답에 포함된 행 수와 요청한 필드에 따라 달라집니다. 어떤 요청이든 최소 비용은 50유닛입니다. 엔드포인트가 무료인 경우 문서 페이지에 해당 안내가 표시되며, 그렇지 않으면 유닛이 소비됩니다.

관련 가이드: 한도 소모

대상 유료 플랜에는 매월 API 단위 허용량이 포함되어 있습니다. 종량제 사용을 지원하는 플랜에서는 포함된 한도를 초과하는 즉시 추가 단위가 자동으로 청구됩니다.

연간 구독을 이용 중이라면, 더 많은 API 단위를 할인된 요금으로 선결제해 비용을 절약할 수 있습니다. 계정 설정 / 한도 및 사용량에서 API 단위 사용량을 추적하고 선결제 추가 옵션을 구매할 수 있습니다.

함께 보기: 요금제 페이지

API 키

Ahrefs API로 요청을 보내려면 API 키가 필요합니다. 워크스페이스 소유자와 관리자만 API 키를 생성하고 관리할 수 있습니다. 이 작업은 계정 설정 / API 키에서 할 수 있습니다.

관련 가이드: API 키 생성 및 관리

기본 사용법

Ahrefs 보고서에서 제공되는 이 API 버튼으로 빠르게 시작해 보세요. 버튼을 클릭하면 요청이 cURL 명령어로 표시됩니다.

이 버튼은 보고서에 적용한 필터에 따라 cURL 명령어가 동적으로 업데이트되므로, 쿼리 빌더처럼 활용할 수 있습니다.

cURL에는 현재 보고서에 표시된 모든 필드와 지표가 포함된다는 점에 유의하세요. 불필요한 필드를 제거하면 요청 비용을 줄일 수 있습니다.

전체 사용 방법은 이 문서의 API 레퍼런스를 확인하세요. 레퍼런스에는 각 엔드포인트의 요청 및 응답 형식에 대한 OpenAPI 호환 사양이 포함되어 있습니다.

속도 제한

Ahrefs API는 기본적으로 분당 60개 요청으로 제한됩니다. 이 한도를 초과하면 API는 HTTP 429 상태 코드(Too Many Requests)로 응답합니다.

또한 최적의 성능과 시스템 안정성을 유지하기 위해, 스로틀링으로 인해 API 요청이 동일한 HTTP 429 상태 코드로 간헐적으로 거부될 수 있습니다. 스로틀링은 실시간 시스템 부하, 리소스 가용성, 요청의 연산 요구량에 따라 동적으로 발생합니다.

링크

• 개인정보처리방침
• 이용 약관