API 가이드
API v3에 대한 전체 상세 레퍼런스는 여기에서 확인할 수 있습니다: Ahrefs API 문서. 이 페이지는 Ahrefs Connect 개발자를 위한 간단한 소개입니다.
API v3로 할 수 있는 일
Ahrefs API v3를 사용하면 다음을 포함한 다양한 데이터를 가져올 수 있습니다:
- 사이트 익스플로러의 오가닉 및 백링크 데이터(내 사이트 또는 경쟁사)
- 키워드 익스플로러의 키워드 지표 및 아이디어
- Google SERP 데이터
- 사용자의 순위 트래커 및 사이트 감사 프로젝트 데이터
- 그 외에도 — 새로운 엔드포인트를 정기적으로 추가합니다
API 유닛 및 요청 비용
무료 테스트 쿼리와 순위 트래커, Management, Public 및 기타 일부 엔드포인트를 제외한 모든 요청은 연결된 사용자의 계정에서 API 유닛을 소모합니다.
비용 규칙:
- 반환되는 행 수와 요청한 필드에 따라 달라집니다
- 유료 요청의 최소 비용: 50 유닛
- 엔드포인트가 무료인 경우, 해당 문서 페이지에 무료로 표시됩니다
개발 중
작동 방식에서 설명한 것처럼, 앱을 처음 만들면 비활성 상태가 됩니다. 이 모드에서는 유닛을 소모하지 않고 스테이징 환경에서 OAuth 플로우를 테스트하고 API v3 엔드포인트에 무료 테스트 요청을 보낼 수 있습니다. 앱이 승인되고 활성화되면, 프로덕션 요청은 일반 비용 규칙에 따라 유닛을 소모합니다.
info
사용자의 API 유닛을 절약하기 위한 모범 사례
사용자를 대신해 요청을 보낼 때는 사용자의 월간 할당량을 염두에 두세요.
유닛 소모를 최소화하는 방법은 다음과 같습니다:
select를 사용해 필요한 필드만 요청하세요: 대부분의 엔드포인트에서는 필드를 지정할 수 있습니다.- 행 수를 제한하세요:
limit또는 이에 상응하는 파라미터를 사용하세요. 필요하지 않다면 수천 개의 행을 가져오지 마세요. - 가능하면 벌크 엔드포인트를 사용하세요: 예를 들어
batch-analysis를 사용하면 한 번의 요청으로 여러 페이지의 지표를 가져올 수 있습니다. - 사용자가 사용량을 모니터링할 수 있게 하세요:
limits-and-usage엔드포인트에서 남은 유닛 수를 확인할 수 있습니다.