본문으로 이동
SEOCheck$100 무료 받기

문서

엔드포인트 레퍼런스 및 가격

하나의 URL, 다양한 액션. 전체 기능 영역입니다.

SEOCheck 연구팀 ·

안개 낀 계곡을 가로지르는 튼튼한 돌다리로, 신뢰할 수 있는 API 엔드포인트를 상징합니다

액션 및 비용

액션크레딧반환 값
domain무료도메인 기본 기록 및 DR
overview무료도메인 링크 프로필 요약
stats무료인덱스 전체 통계
suggest무료입력 중 도메인 제안
bulk_dr1최대 2,000개 도메인의 DR
compare1최대 20개 도메인 비교
top1상위 도메인
dr_distribution1링크 도메인 간 DR 분포
tld_breakdown1최상위 도메인별 링크
refdomains2링크 도메인
backlinks2개별 백링크
anchors2앵커 텍스트
toppages2가장 많이 링크된 페이지
anchor_cloud2앵커 가중치
intersect22~10개 도메인의 공통 링크 제공자
search3앵커, 제목, URL 전체 텍스트 검색
keyword3정확한 앵커로 링크된 도메인

인증 및 형태

기본 URL: https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... 헤더를 선호하시나요? 대신 Authorization: Bearer sk_...를 전송하세요.

이 백링크 분석 API는 JSON 형식으로 응답하며 교차 출처 호출을 허용하므로 브라우저에서 직접 호출할 수 있습니다. 모든 응답에는 ok 필드가 포함됩니다. 인증된 응답에는 _credits 필드가 포함되어 해당 호출의 비용과 남은 잔액을 나타냅니다.

오류 처리는 단순합니다. HTTP 401은 키가 누락되었거나 잘못되었음을 의미합니다. HTTP 402는 잔액이 부족했음을 의미합니다. 둘 다 처리하기 쉬우며 루프 내에서 재시도하면 안 됩니다.

첫 번째 유료 호출 전

  • 알고 있는 도메인에 대해 overview를 실행하세요. 무료입니다.
  • compare와 같은 1 크레딧 호출로 키가 작동하는지 확인하세요.
  • 응답에서 _credits를 읽고 비용이 위의 표와 일치하는지 확인하세요.
  • HTTP 402에 대한 스크립트 알람을 설정하여 잔액 고갈이 조용히 실패하지 않도록 하세요.

페이지네이션 및 정렬

호출당 행 수는 최대 1,000개까지 가능합니다. per를 사용하여 10에서 5000 사이로 행 수를 조정하고, page로 이동하며, sort와 order로 정렬하세요.

bash
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
전용 전정 가위로 정성스럽게 분재를 다듬는 정원사로, 정밀한 조정을 나타냅니다

응답을 변경하는 파라미터

모든 액션은 action과 q라는 두 가지 기본 파라미터를 취한 후 짧은 옵션 집합을 사용합니다. 먼저 옵션을 읽어보세요. 대부분의 실수는 비용이나 행의 형태를 변경하는 선택적으로 보이는 옵션에서 비롯됩니다. 포럼이나 블로그에서 호출을 복사하기 전에 옵션을 읽어보세요.

아래 예제는 key 파라미터에 키가 있다고 가정합니다. 플레이스홀더를 자신의 키로 바꾸세요. 키는 파일에 저장하지 말고 환경 변수에 보관하세요. 이 백링크 분석 API 레퍼런스의 모든 예제는 동일한 기본 URL을 사용합니다.

page와 per를 사용한 페이지네이션

per 옵션은 10에서 5000까지 반환되는 행 수를 설정합니다. page 옵션은 집합을 통해 이동합니다. 500개의 행을 요청한 후 page 2를 호출하면 동일한 행의 다음 풀이 아닌 다음 블록이 반환됩니다.

깊은 페이지네이션은 50,000행에서 중단됩니다. 해당 수보다 많은 데이터가 필요한 경우 sort로 쿼리를 좁히거나 도메인별로 작업을 분할하여 모든 호출이 한도 내에 있도록 하세요.

sort 및 order를 활용한 정렬

스크립트에서가 아닌 서버에서 정렬하세요. sort=dr&order=desc를 요청하면 가장 강력한 링크 도메인부터 반환되므로, 관심 있는 행이 첫 페이지에 나타납니다. 전체 다운로드 후 필터링하면 시간과 크레딧이 모두 낭비됩니다.

가장 약한 행을 원할 경우 order=asc를 사용하세요. 예를 들어 링크가 약한 곳을 찾거나 프로필에서 급격한 하락을 발견할 때 유용합니다.

리스트: bulk_dr, compare, intersect

리스트 액션은 한 번의 호출로 여러 도메인을 처리합니다. bulk_dr는 GET 쿼리 문자열 또는 POST 바디를 통해 최대 2,000개의 도메인을 1 크레딧으로 처리합니다. compare는 최대 20개 도메인을, intersect는 2~10개 도메인을 처리합니다.

가격이 행 수에 의존하지 않으므로, 한 번의 긴 호출이 여러 번의 짧은 호출보다 저렴합니다. 월요일에 1,500개의 후보 사이트를 확인한다고 가정해 보세요. 이는 1,500번의 호출이 아닌 단 한 번의 호출입니다.

검색 및 키워드 호출은 비용이 더 많이 듭니다

search 액션은 앵커, 제목, URL 전체를 대상으로 텍스트 검색을 수행합니다. keyword 액션은 특정 앵커로 연결된 사이트를 조회합니다. 둘 다 호출당 3 크레딧이므로, 탐색용이 아닌 특정 질문에 답하기 위해 사용하세요.

첫 조회 시 per와 page 설정하기

새 도메인을 처음 확인할 때는 per를 50과 같이 작은 값으로 시작하세요. 짧은 응답으로 행의 형태, 필드 이름 및 비용을 한눈에 파악할 수 있습니다. 행이 필요하는 데이터임을 확인한 후에야 per 값을 높여야 합니다. 위의 테이블에 있는 모든 액션에 이 습관이 적용됩니다.

흔히 하는 실수는 첫 시도에서 5,000개의 행을 요청한 후 대부분을 버리는 것입니다. 응답이 커지고 대기 시간이 길어지며, 기대했던 절약 효과는 나타나지 않습니다.

크레딧 미터 읽기

모든 인증된 응답은 _credits로 끝나며, 이는 해당 호출의 비용과 호출 후 잔액을 나타냅니다. 이를 로그에 기록하세요. 월말에 합산하면 실제 청구 금액을 단위까지 정확히 알 수 있습니다.

대략적인 예산이 도움이 됩니다. 1,000회의 refdomains 호출은 2,000 크레딧이 필요하며, 이는 $0.20입니다. 1,000회의 search 호출은 3,000 크레딧, 즉 $0.30이 필요합니다. 2,000개 도메인 목록에 대한 일일 bulk_dr 실행은 1 크레딧이 필요하므로 월 약 $0.003입니다.

Ahrefs가 나열한 대로 월 $129부터 시작하는 200,000 API 유닛 플랜과 비교하면 청구서의 형태가 다릅니다. 그 차이에 대해서는 비교를 참조하세요.

서로 다른 두 가지 오류 유형을 나타내는 서로 다른 무게를 균형 있게 유지하는 빈티지 황동 저울

오류 및 _credits 필드 읽기

응답은 두 가지 다른 방식으로 실패할 수 있으며, 코드에서 이를 구분해야 합니다. 이는 서로 다른 문제입니다. 잘못된 키는 구성 문제입니다. 잔액이 부족하면 청구 문제입니다. 둘을 하나의 일반 오류로 처리하면 어떤 수정이 필요한지 알 수 없습니다.

먼저 ok 필드를 확인하세요. 그 다음 _credits 블록을 읽으세요. 그 후에야 행을 확인해야 합니다. 호출 비용이 이미 알려져 있으면 누락되거나 짧은 결과를 설명하기가 훨씬 쉽기 때문입니다.

401과 402를 별도로 처리하세요

HTTP 401은 키가 누락되었거나 잘못되었음을 의미합니다. 작업을 중지하고 키를 수정하세요. HTTP 402는 잔액이 소진되었음을 의미합니다. 계정 페이지에서 충전한 후 계속 진행하세요. 401의 재시도는 도움이 되지 않으며, 충전 없이 402를 재시도해도 소용이 없습니다.

실행 전후 잔액 로그 기록

실행 시작 시와 종료 시 _credits 잔액을 기록하세요. 그 차이는 수행한 호출에서 예상한 금액과 일치해야 합니다. 예상보다 큰 증가가 발생하면 루프가 의도한 것보다 더 자주 실행되었음을 의미합니다.

빠른 확인을 위해 호출 수에 크레딧 비용을 곱하세요. 답이 40이고 잔액이 4,000 감소했다면, 가격표가 아닌 스크립트에 문제가 있다는 뜻입니다.

요청한 행 확인하기

예상보다 행 수가 적은 성공적인 응답이 반드시 오류는 아닙니다. 작은 도메인은 링크가 적을 수 있습니다. 행 수를 요청한 per 값과 비교하고, 차이를 숨길 결함이 아니라 답변해야 할 질문으로 취급하세요.

저렴한 호출부터 테스트하세요

작업에 호출을 연결하기 전에, 가장 작은 적절한 옵션으로 한 번 수동으로 실행해 보세요. 응답, 필드 이름 및 _credits 값을 확인하세요. 두 번째 행에서 실패하는 작업은 첫 시도에서 실패한 호출보다 디버깅이 훨씬 어렵습니다.

API와의 첫 세션

이후 호출이 이미 이해한 호출이 되도록 순서대로 네 가지 호출을 수행합니다. 첫 번째 호출만 무료이며, 이는 의도된 것입니다.

01

알고 있는 도메인에서 overview 실행하기

무료이며 키가 필요하지 않습니다. 서머리를 검색 콘솔과 사이트 자체에서 확인한 내용과 비교하여 정상적인 응답이 어떤 모습인지 파악하세요.

02

키를 1 크레딧 호출로 테스트하세요

compare를 도메인과 경쟁사 하나에 대해 실행하세요. ok 필드가 true이고 _credits가 1크레딧의 비용을 표시하는지 확인합니다.

03

작은 per로 2크레딧 목록을 가져옵니다.

refdomains를 per=50 및 sort=dr로 요청합니다. 행 수와 크레딧 비용이 위의 표와 일치하는지 확인합니다.

04

비용을 로그에 기록합니다.

시작 전과 후의 잔액을 기록하세요. 이제부터 작성하는 모든 스크립트는 이 습관으로 시작되며, 예상치 못한 청구서는 신비로운 숫자가 아니라 로그의 한 줄이 됩니다.

요금제

선불 크레딧 방식입니다. 크레딧 1개는 $0.0001입니다. 구독이나 월 최소 사용량이 없습니다.

무료 액션

$0

  • 도메인, 개요, 통계, 제안
  • 키 필요 없음
  • 웹 체크기를 구동합니다
체크기 열기

사용량 기반 과금

$0.101,000회 1크레딧 호출당

  • 가입 시 $100 무료 크레딧 제공
  • 카드 불필요
  • USDT(TRC-20)로 충전하기
  • 호출 횟수당 1회 청구, 행 단위 아님
$100 무료 크레딧 받기

알아야 할 제한 사항

인덱스는 181,132,097개의 도메인과 2,774,625,913개의 도메인 링크를 포함합니다. 대략 월 1회 업데이트되며, 일일 크롤링보다는 느린 속도입니다.

심층 페이지네이션은 50,000행에서 중단됩니다. 더 많은 데이터를 가져오려면 sort로 쿼리를 좁히거나 도메인별로 분할하세요.

로그인은 Google만 지원하며, 충전은 USDT로 가능합니다. DR 체커로 시작하거나, 경쟁사 가이드로 라이벌 분석을 시도해 보세요. 순수 링크 빌딩을 위해 일부 팀이 Ahrefs API를 포기하는 이유를 읽어보세요.

자주 묻는 질문

행 단위 요금이 있나요?

아니요. 10행이든 1,000행이든 호출당 1회만 청구됩니다.

크레딧이 고갈되면 어떻게 되나요?

API는 HTTP 402를 반환합니다. 계정 페이지에서 USDT(TRC-20)로 충전한 후 계속 진행하세요.

API 키는 어디에서 찾나요?

Google 로그인 후 대시보드에서 확인할 수 있습니다.