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

참조

백링크 API 참조: 액션, 비용 및 오류

모니터가 알아야 할 사실들을 한 페이지로 정리했습니다: 각 액션의 비용, 페이지네이션 방식, API의 오류 처리 방법.

아래로 작은 배가 항해하는 강 위의 석교

크레딧 비용별 액션

1 크레딧 = $0.0001. 호출당 행 수에 관계없이 한 번만 청구되며, 호출당 최대 1,000행까지 처리됩니다.
비용액션비고
무료, 키 불필요domain, overview, stats, suggest대시보드 및 DR 체커에 적합
1 크레딧bulk_dr, compare, top, dr_distribution, tld_breakdownbulk_dr은 최대 2,000개의 도메인(GET domains= 또는 POST body)을 처리합니다. compare는 최대 20개까지
2 크레딧refdomains, backlinks, anchors, toppages, anchor_cloud, intersectintersect는 2~10개의 도메인을 처리합니다
3 크레딧search, keyword앵커, 제목, URL 전체 텍스트 검색; keyword는 정확한 앵커 텍스트로 연결된 사이트를 찾습니다

인증 및 상태 코드

키는 key= 또는 Bearer 헤더로 전달합니다. 본문 파싱 전 HTTP 코드를 확인하세요.

bash
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
  "https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"

# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
  200) jq '._credits' out.json ;;      # cost and remaining balance
  401) echo 'bad or missing key' ;;
  402) echo 'out of credit: top up' ;;
  *)   echo "unexpected $code" ;;
esac

매개변수 및 오류

항목값의미
q도메인조회 대상
page, perper은 10~5000 범위페이지네이션; 호출당 행 수는 1,000으로 제한되며, 심층 페이지네이션은 50,000까지 가능
sort, orderorder=asc 또는 desc반환된 행의 정렬
ok모든 응답에 포함호출 성공 여부
_credits인증된 응답에서만 사용 가능호출 비용 및 잔여 잔액
HTTP 401키 누락 또는 오류키 또는 헤더 확인
HTTP 402크레딧 고갈USDT(TRC-20)로 충전
작업대 위에서 나무를 측정하고 도구를 선택하는 목수

스케줄링 전 호출 설계

대부분의 API 문제는 응답이 아닌 요청에서 시작됩니다. SEO 백링크 API 통합은 첫 번째 호출 전에 내리는 작은 결정들의 집합입니다. 키, 페이지 크기, 정렬 순서를 먼저 결정하세요.

스크립트에서 키 분리

키는 환경 변수나 시크릿 저장소에 저장하고, 커밋되는 파일에는 넣지 마세요. key 매개변수 또는 Bearer 헤더로 전달하세요. 헤더를 사용하면 키가 로그에 남기 쉬운 주소에 포함되는 것을 피할 수 있습니다.

라이브 키를 티켓이나 채팅에 붙여넣지 마세요. 공유 로그에 표시된 키는 노출된 것으로 간주하세요.

의도적으로 페이지 크기 선택

per 매개변수는 10~5000 범위이지만, 호출당 최대 1,000행까지 한 번만 청구되므로 페이지가 클수록 요금이 줄어듭니다. 3,400행이 필요하다고 가정해 보세요. 10행씩 340번 호출하는 대신, 1,000행씩 4번 호출하면 됩니다.

파일 정렬을 위해 실행 간 페이지 크기를 동일하게 유지하세요.

정렬 순고 고정

sort와 order를 명시적으로 설정하여 기본값에 의존하지 마세요. 동일한 파라미터를 사용하면 주 단위로 출력을 비교할 수 있으므로, diff는 행의 재배열이 아닌 실제 변화를 보여줍니다.

순서 변경은 오경보를 발생시키는 쉬운 방법입니다.

숫자 읽기

이 데이터는 자체 링크 그래프입니다: 181,132,097개 도메인, 2,774,625,913개 도메인 간 링크 및 약 798.5천억 개의 백링크를 포함합니다. 대략 월 1회 업데이트됩니다. 그보다 최신 데이터는 포함되지 않으므로, seo backlinks api는 주 단위로 폴링하는 것이 가장 좋습니다.

DR은 round(100 · log(ref_domains+1) / log(2·10^7))로 계산됩니다. 이는 로그 값입니다. 따라서 100개의 참조 도메인은 27점, 1,000개는 41점, 10,000개는 55점을 받으며, 링크 수를 두 배로 늘려도 점수는 몇 점만 상승합니다. DR은 사이트 간 순위를 비교할 때 사용하고, 심각도 표가 수행하듯 경고에는 원본 개수를 사용하세요.

가격은 선불 방식입니다. 구독이나 최소 금액이 없습니다. 가입 시 제공되는 크레딧은 $100이며, 이는 1,000,000 크레딧에 해당합니다. 이를 Ahrefs API 단위와 비교해 보세요. Ahrefs는 $129/월 요금제에서 200,000 유닛을 판매하며, 요청당 최소 50 유닛을 사용합니다.

비용 계획은 단순 곱셈으로 가능합니다. 한 사이트에 대한 주간 refdomains 호출은 2 크레딧 × 4회 = 월 8 크레딧이며, 이는 $0.0008입니다. 10개 사이트의 경우 비용이 10배가 됩니다. 유실 링크 레시피와 경쟁사 작업은 모두 위의 표에 있는 작업만 사용합니다.

추측 없이 오류를 읽는다

오류 코드는 누가 행동해야 하는지 알려줍니다. 그렇게 읽어야 응답은 미스터리가 아닌 라우팅 결정이 됩니다. 모니터에게 가장 중요한 두 가지 코드는 401과 402입니다.

401과 402는 서로 다른 문제입니다

401은 키가 누락되었거나 잘못되었음을 의미하며, 누군가가 이를 수정할 때까지 아무것도 성공하지 못합니다. 402는 계정에 크레딧이 부족함을 의미하며, 충전하면 해결됩니다. 서로 다른 담당자에게 라우팅하여 올바른 사람이 메시지를 볼 수 있도록 하세요.

두 오류 모두 사람에게 전달하세요. 조용히 실패하는 모니터는 한 번도 실행되지 않은 모니터보다 더 나쁩니다.

본문보다 상태를 먼저 확인하세요

ok 필드보다 먼저 HTTP 상태를 읽으세요. 응답이 JSON으로 파싱될 수 있지만 여전히 실패를 포함할 수 있으므로, 두 가지가 모두 통과해야 확인이 완료됩니다. 성공 여부와 관계없이 모든 실행 시 상태를 로그에 기록하세요.

복구 가능한 경우에만 재시도하세요

401 오류를 재시도하면 API 호출이 낭비되고 로그에 동일한 실패 기록만 쌓입니다. 네트워크 타임아웃과는 다릅니다. 짧은 간격을 두고 소수의 횟수만큼 재시도한 후 중단하세요.

실패를 숨기고 잔액이 고갈될 때까지 재시도 루프를 돌리는 것보다, 중단하고 알림을 보내는 실행이 더 유용합니다.

매 실행 시 상태를 로그에 기록하세요

성공한 실행을 포함해 모든 실행 시 HTTP 상태 코드와 잔액을 로그에 기록하세요. 3주 후에 실패가 발생했을 때, 그 행이 가장 먼저 확인해야 할 내용입니다.

무료 액션 먼저 사용

domain, overview, stats, suggest는 키가 필요 없으며 비용이 들지 않습니다. 유료 액션에 크레딧을 사용하기 전에 도메인 이름, 정확한 철자, 대략적인 크기 등을 검증하는 데 사용하세요.

크론 작업 전에 확인하세요

  • 액션의 비용은 알려져 있으며 월별 실행 횟수를 곱한 값입니다.
  • 종료 코드와 HTTP 상태 코드를 모두 확인합니다.
  • 402 오류는 인간 사용자에게 알림을 보냅니다.
  • 응답은 정렬된 상태로 저장되므로 변경 사항 비교(diff)이 깔끔하게 유지됩니다.
  • 실행 주기는 월별 갱신 주기와 일치합니다.
정원에서 식물을 깔끔한 줄로 정리하는 정원사

페이지네이션 참고 사항

순서가 중요합니다. 스냅샷에는 per=1000을 사용하고 매주 동일한 sort와 order를 유지하세요. 실행 간 순서가 변경되면 변경 사항 비교 시 노이즈가 발생합니다. 이는 잘못된 경보의 흔한 원인입니다.

사이트가 더 큰 경우? 1,000개 이상의 참조 도메인을 가진 사이트의 경우 page=1, page=2 등으로 페이지를 넘기세요. 각 페이지는 별도의 청구 호출입니다. 깊은 페이지네이션은 50,000행으로 제한되며, 이는 거의 모든 일반 사이트를 커버합니다.

참조에 대한 질문

도메인의 형태를 잘 모르겠을 때 먼저 어떤 작업을 호출해야 하나요?
overview 또는 domain으로 시작하세요. 둘 다 무료이며 키가 필요 없으며, 데이터의 대략적인 규모와 기본 구조를 보여줍니다. 그 후에 refdomains 또는 anchors에 크레딧을 사용하세요.
도메인 하나를 완전히 확인하는 데 비용이 얼마나 들까요?
각 작업의 크레딧을 합산한 후 실행 빈도를 곱하세요. 한 도메인에 대해 refdomains, anchors, tld_breakdown 호출을 매주 실행한다고 가정해 보세요. 이는 한 번 실행당 2 + 2 + 1 = 5 크레딧, 즉 $0.0005입니다. 4주 동안은 약 $0.002가 됩니다.
같은 도메인의 두 개수가 일치하지 않을 수 있는 이유는 무엇인가요?
비교할 때는 동일한 작업, 동일한 매개변수 및 동일한 새로고침 주기를 사용하세요. 다른 작업에서 얻은 개수는 서로 교체할 수 없으며, 새로고침 중간에 얻은 개수는 일주일 후에 얻은 개수와 다를 수 있습니다.
크레딧을 쓰지 않고 cron 작업을 테스트하는 방법은 무엇인가요?
배선, 상태 처리 및 출력 형식을 확인하려면 먼저 무료 작업을 실행하세요. 그런 다음 숫자를 증명하기 위해 유료 호출을 한 번 수행하고, 테스트 중에는 작업을 단일 실행으로 제한하세요.
1,000개 이상의 참조 도메인을 가진 사이트에서도 페이지네이션이 작동하나요?
네. page를 per와 함께 사용하세요. 각 페이지는 별도의 청구 호출이며, 깊은 페이지네이션은 50,000행으로 제한되며, 이는 대부분의 일반 사이트를 커버합니다.

나쁜 주기를 견디는 모니터

모니터는 모든 것이 잘못되는 주 동안 신뢰를 얻습니다. 첫 번째 실행 전에 느린 응답, 변경된 잔액 및 부분 결과를 예상하세요. 이러한 것은 일반적인 사건입니다. 각 사건은 로그에 명확한 줄을 남겨야 합니다.

타임아웃 및 부분 풀링

모든 호출에 타임아웃을 설정하여 느린 응답이 전체 작업을 차단하지 않도록 하세요. 여러 페이지 풀링 중 한 페이지가 실패하면 해당 페이지를 기록하고 해당 지점부터 다시 시작하세요. 그러면 이미 있는 행에 대해 두 번 지불하는 것을 피할 수 있습니다.

부분 파일을 부분 파일로 표시하여 일반 스냅샷으로 저장하지 마세요. 그렇지 않으면 다음 diff에서 실제로 발생하지 않은 손실이 표시됩니다.

잔액 확인

모든 인증된 응답에서 _credits를 읽고 남은 잔액을 로그에 기록하세요. 작은 스크립트를 사용하여 선택한 바닥값과 비교하고 다음 실행 전에 경고를 보낼 수 있습니다.

바닥값을 500 크레딧이라고 가정해 보세요. 40 크레딧이 드는 주간 실행은 밤중에 402 오류가 발생하기 전에 충전할 여유를 남겨줍니다.

각 작업을 지루하게 유지하세요

각 작업에 하나의 파일과 하나의 일정을 제공하세요. 세 가지 작업을 수행하는 cron 항목은 세 가지 방식으로 실패할 수 있으며, 로그는 어떤 일이 발생했는지 항상 알려줄 수 없습니다. 두 개의 작은 작업이 하나의 똑똑한 작업보다 신뢰하기 쉽습니다.

새로고침에 일정을 맞추세요

시계가 아닌 월간 새로고침에 작업의 일정을 맞추세요. 매일 실행하면 대부분의 날에 동일한 파일을 반환하므로 비용과 노이즈가 추가될 뿐 정보가 추가되지 않습니다. 보통 매주면 충분합니다.