사용량 소비

Ahrefs API는 대상 유료 요금제에서 사용할 수 있습니다. 그 밖의 모든 요금제에서도 무료 테스트 쿼리의 제한된 세트에는 계속 액세스할 수 있습니다.

무료 테스트 쿼리와 순위 트래커, Management, Public 및 일부 기타 엔드포인트를 제외한 모든 요청은 API 유닛을 소모합니다. 엔드포인트가 무료라면 해당 문서 페이지에 안내가 표시되고, 그렇지 않다면 유닛을 소모합니다.

요청당 유닛 소비량은 다음과 같이 계산됩니다:

max(base_cost, per_row_cost * num_rows)

각 요청의 base_cost는 50 유닛입니다. per_row_cost는 반환 결과 또는 where나 order_by 매개변수에 나타나는 각 고유 필드의 비용을 합한 값입니다. 필드가 여러 매개변수에 나타나더라도 한 번만 계산됩니다.

필드의 기본 비용은 1 유닛입니다. 하지만 일부 지표는 비용이 더 높아 5 또는 10 유닛을 소비할 수 있습니다. 이러한 예외 사항은 각 엔드포인트의 필드 설명에 명시되어 있습니다. 캐시에서 제공되는 요청은 유닛을 소모하지 않습니다.

각 API 요청은 다음 응답 헤더를 통해 유닛 소비 동작을 나타냅니다:

• x-api-rows 반환된 행 수.
• x-api-units-cost-row 행당 유닛 비용입니다.
• x-api-units-cost-total 행 수와 행당 비용을 기준으로 요청이 소비해야 하는 전체 유닛입니다.
• x-api-units-cost-total-actual 요청이 실제로 소비한 전체 유닛입니다.
• x-api-cache 요청이 캐시에서 제공되었는지 여부입니다. 다음 중 하나: hit miss no_cache

예시 1

사이트 익스플로러 - 도메인 등급 엔드포인트(/site-explorer/domain-rating)에 대한 요청을 예로 들어 보겠습니다.

이 엔드포인트는 select, where, order_by 파라미터를 받지 않으며, domain_rating과 ahrefs_rank 두 필드가 들어 있는 단일 행을 반환합니다. 이때 행당 비용은 2 유닛입니다.

총 행 비용(행당 비용 × 행 수)은 기본 비용보다 작습니다. 따라서 이 요청의 비용은 기본 비용인 50 유닛입니다.

예시 2

select, where, order_by 파라미터를 설정할 수 있는 사이트 익스플로러 - 백링크 엔드포인트(/site-explorer/all-backlinks)에 대한 더 복잡한 요청을 생각해 보겠습니다.

이 요청에서 두 개의 필드를 선택했다고 가정해 보겠습니다:

select=title,traffic

필터 표현식에는 두 개의 필드가 포함되어 있으며:

where={"and":[{"field":"traffic","is":["gt",1000]},{"field":"refdomains_source","is":["gt",10]}]}

정렬 필드는 다음과 같습니다:

order_by=traffic:desc

이 파라미터 전체를 보면 고유 필드는 3개이며, 이 중 title과 refdomains_source는 각각 1 유닛, traffic은 10 유닛이 듭니다. 따라서 행당 비용은 1 + 1 + 10 = 12 유닛입니다.

요청이 500개 행을 반환한다고 가정해 보겠습니다. 그러면 총 행 비용(12 * 500 = 6000 유닛)이 기본 비용을 초과합니다. 따라서 이 요청의 비용은 6000 유닛입니다.