Rankele
Rankele$100 무료 혜택 받기

참조

Ahrefs 백링크 보고서와 API 출력 비교: 액션 참조

Ahrefs 백링크 내보내기에 익숙하시다면, 이 참조는 어떤 부분을 우리 액션으로 재구성할 수 있는지, 각 호출의 비용은 얼마인지, 그리고 주요 스위트(Suite)들이 어떤 부분에서 우위를 점하는지 보여줍니다.

테이블 위에 나란히 놓인 물리적 지도와 기계적 기어

액션, 가격 및 보고서 대체 항목

공개 목록 기준 가격; 1 크레딧은 $0.0001입니다. 행 필드명은 액션에 따라 다르므로 스크립팅 전에 저장된 응답을 하나 열어보세요.
액션크레딧일반 보고서의 가장 가까운 부분참고 사항
domain, overview, stats, suggest0헤드라인 카운트키 불필요
bulk_dr1목록용 DR 열호출당 최대 2,000 도메인
compare1도메인 나란히 비교최대 20개 도메인
top, dr_distribution, tld_breakdown1요약 차트분포형 요약
refdomains2참조 도메인 탭페이지네이션 적용
backlinks2백링크 탭페이지네이션 적용
anchors, anchor_cloud2앵커 탭클라우드는 표시용임
toppages2링크 기준 상위 페이지링크를 유도하는 페이지
intersect2링크 인터섹트2~10개 도메인
search, keyword3직접적인 매칭 없음앵커, 제목 및 URL 검색

보고서 탭과 우리 액션의 매핑

대부분의 보고서 내보내기는 탭으로 제공되며, 각 탭에는 여기에서 대략적인 대응 항목이 있습니다. 정확히 복사본은 아닙니다. 하나의 탭에 존재하는 필드가 우리 응답에 아예 없을 수 있으므로, 시작점으로 매핑을 읽어보세요.

참조 도메인 탭

DR 기준으로 정렬된 참조 도메인으로 열리는 보고서를 상상해보세요. 우리 API에서 가장 가까운 호출은 refdomains(2 크레딧)이며, 동일한 방식으로 정렬할 수 있습니다. 행 필드명이 액션에 따라 다르므로 스크립트에서 열 이름을 하나 정도 변경해야 할 것입니다.

월별 정렬 기준을 고정하세요. 한 달에는 DR 기준으로 정렬된 목록과 다음 달에는 트래픽 기준으로 정렬된 목록을 비교하면 공정한 diff가 나오지 않으므로, 파일 이름에 정렬 키를 명시하세요.

앵커 탭 및 클라우드가 표시용인 이유

anchors는 2 크레딧의 앵커 탭 호출용입니다. anchor_cloud도 동일한 비용이 들지만, 위 표에 명시된 대로 이는 표시용으로 설계되었습니다. 숫자에 기반한 의사결정이 필요하다면 일반 목록을 읽어보세요.

앵커를 읽을 때 질문하세요: '실제 작가가 이런 단어를 입력했을까?' 브랜드 이름과 단순 URL은 대부분 통과합니다. 하지만 여러 도메인에 걸쳐 동일한 금전적 문구들이 반복된다면 이는 통과하지 못하며, 이 부분이 가장 먼저 점검해야 할 부분입니다.

상위 페이지 및 2~10개 도메인 뷰

toppages는 링크 기준 상위 탭에 가장 가까운 기능입니다. 어떤 페이지가 링크를 유도하는지 보여주며, 사이트의 특정 폴더에 랭크 변동이 발생했을 때 도메인 총합보다 더 많은 정보를 제공할 수 있습니다.

intersect는 2~10개 도메인을 받아들이며 호출당 2 크레딧이 소요됩니다. 예를 들어 내 사이트와 두 경쟁사를 비교한다고 가정해 봅시다. 그러면 세 사이트가 공유하는 링크 사이트의 중복 부분을 확인할 수 있으며, 이는 간단하고 저렴합니다.

호출 전반에 적용되는 파라미터

모든 목록을 제어하는 세 가지 요소가 있습니다. 바로 page, per 그리고 sort와 order 쌍입니다. 월별 호출 간에 이 값들을 고정하세요.

per은 10~5000을 허용하지만, 한 호출당 최대 1,000개의 행이 반환되며 깊은 페이지네이션은 50,000행에서 중단됩니다. 행 수에 관계없이 호출당 한 번 청구되므로, 전체 페이지를 요청하든 10개 행만 요청하든 비용은 동일합니다.

인증은 쿼리에 key=sk_...를 사용하거나 Authorization: Bearer sk_... 헤더를 통해 수행합니다. CORS는 개방되어 있지만, 브라우저 코드에서 키가 모든 방문자에게 노출되므로 서버에서 키를 유지하세요.

순서가 중요합니다. 결과를 페이지네이션할 때, 중요할 가능성이 높은 도메인은 DR 기준 내림차순으로, 작은 사이트의 긴 꼬리(long tail)를 조사하려면 오름차순으로 정렬하세요. 선택한 정렬 기준을 파일 옆에 기록하세요.

위 표를 지도로, 저장된 응답을 실제 영토로 간주하세요. 기대했던 필드가 누락된 경우, 존재하는 필드들을 기반으로 구조를 구성하세요.

월별 내보내기를 5단계로 실행

매월 동일한 5단계를 실행하여 비교 시 저장된 파일들이 일치하도록 하세요.

  1. 1

    호출 선택

    각 도메인에 대해 refdomains, anchors, toppages를 선택하세요. overview와 stats는 무료이므로 같은 폴더에 추가하세요.

  2. 2

    깊이 고정

    page, per, sort, order를 한 번 설정하고 유지하세요. per는 최대 5000까지 설정 가능하지만, 단일 호출당 최대 1,000개의 행이 반환됩니다.

  3. 3

    응답 그대로 저장

    파싱 전에 원본 JSON을 디스크에 기록하세요. 나중에 스크립트가 실패할 경우, 다시 실행할 수 있는 저장된 사본이 필요합니다.

  4. 4

    _credits 객체 읽기

    각 인증된 응답은 비용과 남은 잔액을 보고합니다. 이를 로그 라인에 복사하여 대시보드 없이도 월별 지출을 확인할 수 있게 하세요.

  5. 5

    지난 달과 비교

    저장된 사본을 diff하세요. diff 레시피에는 유지할 가치가 있는 세 가지 열이 나열되어 있습니다.

무거운 돌을 작은 자갈들과 저울질하는 황동 저울

크레딧, 행 제한 및 월별 청구

가격 목록은 짧습니다. 청구 금액은 호출 빈도와 페이지네이션 방식에 따라 달라집니다. 이 중 대부분은 세 가지 습관에 의해 결정됩니다.

행 수에 관계없이 호출당 한 번 청구

각 호출은 한 번 청구되므로, 동일한 액션에서 per=1000은 per=10과 비용이 동일합니다. 재사용할 목록의 경우 전체 페이지가 저렴하지만, 빠른 확인용으로는 낭비일 수 있습니다.

매달 같은 날 한 도메인의 refdomains를 가져온다고 가정해 봅시다. 이는 월간 2 크레딧, 즉 크레딧당 공개 가격인 $0.0001 기준으로 $0.0002입니다.

50,000행 한도

깊은 페이지네이션은 50,000행에서 중단됩니다. 이후에도 계속 다음 페이지를 요청하는 루프는 새로운 데이터를 반환하지 않으므로, 루프 시작 전에 페이지 수를 제한하세요.

호출당 1,000행으로 한도에 도달하려면 50번의 호출이 필요합니다. 호출당 2 크레딧이므로 총 100 크레딧, 즉 $0.01입니다. 저렴하지만 스크립트가 적절한 시점에 중단될 때만 해당합니다.

월간 습관을 위한 작은 예산

10개 도메인을 가정하고, 각 도메인의 refdomains와 anchors를 월간 한 번씩 가져온다고 해봅시다. 이는 월간 40 크레딧, 즉 $0.004이며, 가입 시 제공되는 무료 크레딧 $100(1,000,000 크레딧)에서 차감됩니다.

이 속도로라면 무료 크레딧은 오래 지속되며, 지출 로그는 해당 속도가 유지되는지 보여줍니다. 이를 유지하세요.

응답 문제 해결

표시됨원인해결책
HTTP 401키 누락 또는 오류키와 헤더 철자 확인
HTTP 402크레딧 고갈계정 페이지에서 USDT(TRC-20)로 충전
ok가 false임요청이 거부됨본문의 메시지 및 전송한 파라미터 읽기
주요 스위트보다 행 수가 적음다른 인덱스 및 크롤링 타이밍총합이 아닌 추세 비교
지난 주 만든 링크가 누락됨인덱스 약 월간 재구축다음 주기에서 다시 확인
햇빛 아래 두 방향으로 갈라지는 안개 낀 숲길

누락된 행은 답이 아닌 질문임

두 응답 간에 행이 사라지는 것은 흔한 놀라움입니다. 그 의미를 결정하기 전에, 해당 행이 전달할 수 있는 여러 시나리오를 구분하세요.

누락된 행 뒤의 세 가지 시나리오

링크가 인덱싱되지 않았을 수도 있고, 제거되었을 수도 있습니다. 세 번째 시나리오는 타이밍 문제입니다: 페이지가 인덱스 재구축 전후에 크롤링되었고, 행은 이후 주기에서 나타납니다.

단일 호출로는 이를 구분할 수 없습니다. 나중에 추가로 확보한 사본과 페이지 자체 검토를 통해 범위를 좁혀야 합니다.

추적하기 전에 행의 가치를 평가하세요

아웃리치 전에 도메인의 DR과 링크 페이지를 확인하세요. 약한 사이트에서 제거된 링크는 계획에 큰 영향을 미치지 않습니다. 하지만 독자를 끌어모은 페이지에서 제거된 링크라면 소유자에게 메모를 남길 가치가 있습니다. 의심스러운 표는 누락된 행이 광범위한 원인 중 어디에 위치하는지 보여줍니다.

내보내기를 우리 호출로 이동

Ahrefs에서 제공하는 동일한 열을 내보낼 수 있나요?

일대일로 매칭되지는 않습니다. 행 필드명은 액션에 따라 다르므로 저장된 응답을 열고 필드명을 직접 매핑하세요. 위 표는 보고서의 각 부분에 가장 가까운 액션을 명시하지만, 필드명은 다를 것입니다.

API가 Ahrefs 구독보다 저렴합니까?

답변은 호출량에 따라 달라집니다. 우리 공개 가격은 1,000회 1크레딧 호출당 $0.10입니다. Ahrefs는 구독 내에 API 단위를 판매하며, 월 $129에 200,000 단위(요청당 최소 50 단위)로 시작합니다. 결정하기 전에 호출 수를 세어보세요.

이전 내보내기와 새 내보내기를 비교할 수 있나요?

정렬, 깊이 및 소스가 일치할 때만 가능합니다. 다른 도구에서 다른 주에 가져온 파일은 다른 샘플입니다. 이전 파일들을 보관하고, 새 시리즈는 명확히 레이블이 지정된 쌍으로 시작하세요.

키를 서버에 유지해야 하나요?

네. CORS가 개방되어 있어 브라우저에서 API를 호출할 수 있지만, 프론트엔드 코드에 키가 있으면 모든 방문자에게 노출됩니다. 서버에서 요청을 보내고 환경 변수에서 키를 읽으세요.

이 호출들을 기반으로 보고서를 구축하기 전

  • 각 액션당 저장된 응답을 하나 열고 실제로 받는 행 필드명을 확인하세요.
  • 모든 파일 이름에 들어갈 월 레이블을 결정하세요.
  • 월별 가져오기 간 page, per, sort, order를 동일하게 유지하세요.
  • 각 인증된 응답에서 _credits 객체를 로그에 기록하여 작업별 지출을 확인하세요.
  • 목록은 50,000행에서 중단되므로 스크립트에서 깊은 페이지네이션을 제한하세요.
  • 인덱스가 약 월간으로 갱신된다는 내용을 전달할 보고서에 신선도 메모를 추가하세요.

봉투 읽기

모든 응답에는 ok가 포함됩니다. 인증된 응답에는 _credits도 추가되므로 작업별 지출을 로그에 기록하고 잔액을 모니터링할 수 있습니다.

bash
curl -s "https://rankele.com/api.php?action=toppages&q=example.com&per=50&key=sk_live_..." | head -c 600

# header style
curl -s -H "Authorization: Bearer sk_live_..." \
  "https://rankele.com/api.php?action=bulk_dr&domains=example.com,example.org"
Ahrefs와 Semrush의 우위

Ahrefs는 구독 내에 API 단위를 판매하며, 월 $129에 200,000 단위(요청당 최소 50 단위)로 시작합니다. 또한 키워드, 랭크 추적 및 더 신선한 크롤링을 제공하며, Semrush도 마찬가지입니다. 우리는 낮은 호출당 가격으로 링크 데이터를 제공하며 그 이상은 제공하지 않습니다. 필요한 간격을 채우려면 월간 실행서를 사용하세요. 스팸 급증 의사결정 트리는 저렴한 요약 호출의 좋은 첫 사용 사례입니다.