API를 통해 도메인 백링크 확인은 어떻게 작동하나요?

q에 도메인을 지정해 overview, refdomains 또는 backlinks와 같은 액션으로 요청하고 JSON을 읽으세요. 무료 액션에는 키가 필요 없습니다. 유료 액션은 Bearer 헤더 또는 key= 파라미터로 키를 전달해야 하며, 행 수에 관계없이 호출당 1~3 크레딧이 청구됩니다.

브라우저에 키를 넣어야 하나요?

아니요, 넣지 않는 것이 좋습니다. CORS가 열려 있어 브라우저에서 API를 호출할 수 있지만, 클라이언트 코드에 키를 넣으면 모든 방문자에게 공개됩니다. 유료 호출은 서버에서 처리하고 프론트엔드는 자체 라우트를 통해 통신하게 하세요.

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

API는 HTTP 402를 반환합니다. 키가 없거나 잘못되었으면 HTTP 401을 반환합니다. 둘 다 재시도 신호가 아닌 중단 신호로 처리하세요. 계정 페이지에서 USDT(TRC-20)로 충전하면 동일한 키로 계속 작동합니다.

호출당 반환되는 행 수는 어떻게 되나요?

호출당 최대 1,000행이 반환되며, 행 수에 관계없이 호출당 1회 청구됩니다. page와 per로 페이지네이션하세요. 심층 페이지네이션은 50,000행으로 제한되므로, 더 큰 데이터 내보내기의 경우 정렬 또는 다른 액션을 사용해 쿼리를 좁히세요.

DR이 Ahrefs의 DR과 동일한 수치인가요?

아닙니다. 여기서의 DR은 저희만의 지표입니다: round(100 log(ref_domains + 1) / log(2 10^7)). Ahrefs의 DR이나 Moz의 DA와 정신적으로 유사하지만, 저희 자체 인덱스를 기반으로 계산되므로 도구 간 수치를 비교하기보다 단일 도구 내의 추세를 비교해야 합니다.

링크 데이터는 얼마나 최신인가요?

대략 1개월 정도입니다. 인덱스는 월 1회 정도 재구축되므로 최근 링크가 누락될 수 있습니다. 신규 링크에 대한 일일 알림을 제공한다는 제품이 있다면 일일 크롤링 벤더가 필요하며, 저렴한 대량 데이터는 이 API를 사용해야 합니다.

월 구독료나 최소 사용량이 있나요?

구독료도 최소 사용량도 없습니다. 크레딧은 선불 방식입니다: 1 크레딧은 $0.0001이며, 1,000회 호출 시 $0.10이 발생합니다. 신규 계정은 Google 로그인만으로 카드 등록 없이 $100 무료 크레딧을 제공합니다.

JSON 형식의 백링크 데이터: $100 무료 크레딧, 카드 불필요, Google 로그인.

798.5억 개의 백링크가 인덱싱됨

자체 대시보드용 도메인 백링크 확인

참조 도메인, 앵커 텍스트, 상위 페이지 및 DR을 JSON 형식으로 반환하는 REST 엔드포인트입니다. 이 엔드포인트를 기반으로 도구를 구축하세요. 첫 $100 호출은 무료입니다.

$100 무료 혜택 받기 대량 DR 스크립트 읽기

키가 필요 없는 네 가지 작업
한 번의 호출로 최대 2,000개 도메인 점수 확인
CORS, Bearer 또는 쿼리 문자열 키 사용

GET /api.php?action=domainJSON

$ curl "https://seomasters.dev/api.php?action=overview&q=nytimes.com&key=sk_live_..."

용도

도메인 백링크 확인: 먼저 연결할 네 가지 엔드포인트

모든 액션은 q의 대상 값을 받아 ok 플래그가 포함된 JSON을 반환합니다. 멋있어 보이는지보다 화면이 필요로 하는 기능에 따라 선택하세요.

무료 조회, 키 불필요

domain, overview, stats, suggest는 무료입니다. 공개 위젯이나 CI 환경의 스모크 테스트에 활용하세요.

포트폴리오 전체의 도메인 평점(DR) 일괄 조회

bulk_dr은 호출당 최대 2,000개 도메인의 평점을 1 크레딧에 계산합니다. 하루 한 번의 요청으로 대량의 클라이언트 목록을 처리할 수 있습니다.

링크 걸린 도메인 및 앵커 텍스트

refdomains, anchors, backlinks는 호출당 2 크레딧이 필요하며, 각 항목당 최대 1,000행까지 조회 가능합니다. page, per, sort, order 파라미터를 지원합니다.

차이점 분석을 위한 교집합 기능

intersect는 2~10개 도메인을 입력받아 공통으로 링크를 걸고 있는 도메인을 나열합니다. 행 수에 관계없이 2 크레딧이 필요합니다.

대상

JSON 뒤에 있는 것들

수치는 자체 크롤러와 자체 링크 인덱스에서 가져온 것입니다: 181,132,097개 도메인, 2,774,625,913개의 도메인 간 링크, 그리고 약 798.5천억 개의 백링크입니다. 제3자로부터 재판매된 데이터는 없습니다.

인덱스는 대략 월 1회 갱신됩니다. 최근 추가된 링크가 누락될 수 있으므로, 실시간 데이터를 약속하기보다는 인덱스 연령(age)을 표시하는 방식으로 UI를 설계하세요.

인증된 응답에는 호출 비용과 남은 잔액을 나타내는 _credits 객체가 포함됩니다. 이를 로그에 기록하세요. 재무 담당자가 지출 내역을 물을 때, 정답은 이미 모든 응답에 포함되어 있습니다.

코드를 작성하기 전에 다음 두 페이지를 읽어보세요: DR 필드 참조는 0-100 점수의 의미를 설명하며, 대시보드 프록시 가이드에서는 키를 어디에 배치해야 하는지 보여줍니다.

첫 렌더링에 수치가 필요한가요?

페이지를 보는 대상에 따라 다릅니다. 검색 엔진에 인덱싱되도록 하는 공개 조회 페이지라면 HTML에 수치를 이미 포함해야 합니다. 로그인 대시보드는 로딩 후 데이터를 가져올 수 있지만, 느린 스마트폰에서 빈 테이블이 표시되면 여전히 깨진 것처럼 보입니다.

우리가 제안하는 기본 방식은 간단합니다: 서버가 API를 호출하고 행을 렌더링하며, 브라우저는 정렬과 필터링만 수행합니다. 프록시 가이드에서는 Next.js에서 이 분리를 구현하는 방법과 라우트 핸들러 포함 방법을 보여줍니다.

키의 위치, 다시 한번

키는 방문자가 직접 열 수 있는 페이지에 있으면 안 됩니다. 키는 서버 환경 변수에 보관하고, 해당 시크릿이 위치한 환경에서 실행되는 코드에서 호출하세요.

키를 번들 안에 숨긴다고 약속하는 도구들은 일반 사용자에게는 숨겨도, 네트워크 탭을 연 사람에게는 숨길 수 없습니다.

안개 낀 계곡을 가로지르는 돌 기둥들을 연결하는 은색 체인으로 표현된 도메인 백링크

단일 요청, 엔드 투 엔드

키를 교체하세요. q 값은 스키마나 경로 없이 순수 도메인 이름입니다.

bash

curl -s "https://seomasters.dev/api.php?action=refdomains&q=example.com&per=100&sort=dr&order=desc" \
  -H "Authorization: Bearer sk_live_..."

# header or ?key= both work
# ok=false or HTTP 401/402 means stop and read the error

체크리스트

첫 프로덕션 배포 전

키는 서버 사이드 환경 변수에 보관하며 브라우저 번들에는 포함되지 않습니다
모든 응답은 HTTP 상태뿐만 아니라 ok 여부도 확인합니다
HTTP 401 및 402는 자동으로 재시도되지 않습니다
_credits는 호출 시마다 자체 로그에 기록됩니다
UI는 월간 갱신 시점을 표시하므로 데이터가 실시간이 아님을 알 수 있습니다
페이지네이션은 50,000행 한도에 도달하면 무한 루프 대신 중단됩니다

범위

링크 데이터 API이며, 전체 SEO 스위트는 아닙니다

키워드 리서치, 랭킹 추적 및 최신 크롤링은 Ahrefs나 Semrush가 더 적합합니다. Ahrefs의 API는 월 $129부터 시작하는 구독 플랜에 200,000개의 API 유닛이 포함되어 있습니다. 반면 이 API는 호출마다 링크 데이터를 가격 책정합니다.

적합: 대시보드, 감사, 일괄 점수 매기기, 내부 도구
비적합: 랭킹 추적, 키워드 검색량, 실시간 링크 알림
데이터는 월간으로 업데이트되며, 문서에서 이를 명시하고 있습니다

작동 방식

로그인부터 야간 작업까지

1
Google로 로그인
계정 페이지에서 sk_ 키를 발급하고 $100 스타터 잔액과 1,000,000 크레딧을 확인하세요.
2
무료 액션 1회 실행
잘 알고 있는 도메인에 대해 overview를 호출하세요. 무언가를 구축하기 전에 예상 결과와 출력을 비교하세요.
3
페치 레이어 작성
fetch를 한 번 감싸세요: 키 주입, ok 확인, _credits 로깅. 페이징 루프에 대한 페이지네이션 참고 사항을 참조하세요.
4
일정 등록
심층 데이터 수집에는 월간, bulk_dr에는 일간으로 실행하세요. 오류 테이블에서 실패 시 대응 방법을 확인하세요.

FAQ

개발자가 가장 먼저 묻는 질문

API를 통해 도메인 백링크 확인은 어떻게 작동하나요?: q에 도메인을 지정해 overview, refdomains 또는 backlinks와 같은 액션으로 요청하고 JSON을 읽으세요. 무료 액션에는 키가 필요 없습니다. 유료 액션은 Bearer 헤더 또는 key= 파라미터로 키를 전달해야 하며, 행 수에 관계없이 호출당 1~3 크레딧이 청구됩니다.
브라우저에 키를 넣어야 하나요?: 아니요, 넣지 않는 것이 좋습니다. CORS가 열려 있어 브라우저에서 API를 호출할 수 있지만, 클라이언트 코드에 키를 넣으면 모든 방문자에게 공개됩니다. 유료 호출은 서버에서 처리하고 프론트엔드는 자체 라우트를 통해 통신하게 하세요.
크레딧이 고갈되면 어떻게 되나요?: API는 HTTP 402를 반환합니다. 키가 없거나 잘못되었으면 HTTP 401을 반환합니다. 둘 다 재시도 신호가 아닌 중단 신호로 처리하세요. 계정 페이지에서 USDT(TRC-20)로 충전하면 동일한 키로 계속 작동합니다.
호출당 반환되는 행 수는 어떻게 되나요?: 호출당 최대 1,000행이 반환되며, 행 수에 관계없이 호출당 1회 청구됩니다. page와 per로 페이지네이션하세요. 심층 페이지네이션은 50,000행으로 제한되므로, 더 큰 데이터 내보내기의 경우 정렬 또는 다른 액션을 사용해 쿼리를 좁히세요.
DR이 Ahrefs의 DR과 동일한 수치인가요?: 아닙니다. 여기서의 DR은 저희만의 지표입니다: round(100 log(ref_domains + 1) / log(2 10^7)). Ahrefs의 DR이나 Moz의 DA와 정신적으로 유사하지만, 저희 자체 인덱스를 기반으로 계산되므로 도구 간 수치를 비교하기보다 단일 도구 내의 추세를 비교해야 합니다.
링크 데이터는 얼마나 최신인가요?: 대략 1개월 정도입니다. 인덱스는 월 1회 정도 재구축되므로 최근 링크가 누락될 수 있습니다. 신규 링크에 대한 일일 알림을 제공한다는 제품이 있다면 일일 크롤링 벤더가 필요하며, 저렴한 대량 데이터는 이 API를 사용해야 합니다.
월 구독료나 최소 사용량이 있나요?: 구독료도 최소 사용량도 없습니다. 크레딧은 선불 방식입니다: 1 크레딧은 $0.0001이며, 1,000회 호출 시 $0.10이 발생합니다. 신규 계정은 Google 로그인만으로 카드 등록 없이 $100 무료 크레딧을 제공합니다.