소개
Ahrefs API를 사용하면 Ahrefs 작업 공간의 데이터를 활용해 사용자 정의 통합 및 자동화를 만들 수 있습니다. 현재 API v3를 사용하면 사이트 익스플로러, 키워드 익스플로러, SERP 개요, 순위 트래커, 사이트 감사, 브랜드 레이더, 소셜 미디어 관리 엔드포인트에서 데이터를 가져올 수 있으며, 순위 트래커 프로젝트와 키워드 익스플로러 목록도 관리할 수 있습니다:
- 사이트 익스플로러: 개요 통계 및 과거 차트, 백링크, 유기적 및 유료 트래픽 보고서
- 키워드 익스플로러: 단일 키워드 또는 키워드 목록의 지표, 검색량 추이 및 국가별 검색량, 키워드 아이디어 보고서
- 사이트 감사: 프로젝트 건강 점수, 전체 이슈 보고서 및 크롤링된 페이지 콘텐츠
- SERP 개요: 상위 100개 SERP 결과
- 순위 트래커: 프로젝트 개요, 경쟁사 보고서 및 순위 트래커 SERP
- 일괄 분석: 요청당 최대 100개 대상의 지표
- 브랜드 레이더: 브랜드 개요 통계, 과거 성과 차트, 그리고 여러 AI 에이전트에 걸친 출처가 포함된 실제 프롬프트
- 소셜 미디어 관리: 연결된 소셜 미디어 계정의 채널, 게시물, 활동 내역 및 지표
- 관리: 순위 트래커 프로젝트 및 키워드 익스플로러 목록을 관리하기 위한 엔드포인트
- 구독 정보: API 제한 및 사용량
- 공개 엔드포인트: 당사 크롤러의 IP 주소 및 범위
이용 자격
Ahrefs API는 자격이 있는 유료 요금제에서 이용할 수 있습니다. 그 외 모든 요금제에서도 제한된 수의 무료 테스트 쿼리는 계속 사용할 수 있습니다.
요금제 한도
무료 테스트 쿼리와 순위 트래커, 관리, 공개 및 일부 다른 엔드포인트를 제외한 모든 요청은 API 유닛을 소비합니다. 비용은 응답에 포함된 행 수와 요청한 필드에 따라 달라집니다. 어떤 요청이든 최소 비용은 50유닛입니다. 엔드포인트가 무료인 경우 문서 페이지에 해당 안내가 표시되며, 그렇지 않으면 유닛이 소비됩니다.
관련 가이드: 한도 소모
info
소비된 API 유닛은 환불이 불가하오니 유의해 주세요. 의도치 않은 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 상태 코드로 간헐적으로 거부될 수 있습니다. 스로틀링은 실시간 시스템 부하, 리소스 가용성, 요청의 연산 요구량에 따라 동적으로 발생합니다.