참조
참조: 각 동작, 비용, 오류 발생 방식
감사 스크립트를 작성하는 동안 이 참조를 열어두세요. 여기에는 동작, 가격, 페이지네이션 제한 및 발생할 수 있는 두 가지 오류가 나열되어 있습니다.
테이블 전제 기초
엔드포인트는 https://backlinkphoenix.com/api.php?action=<action>&q=<domain>&key=sk_...입니다. 키를 Bearer 헤더로 전송할 수도 있습니다. CORS가 열려 있으므로 브라우저 스크립트도 작동합니다.
모든 응답에는 ok 플래그가 포함됩니다. 인증된 응답에는 _credits 필드도 포함되어 호출 비용과 남은 잔액을 나타냅니다. 이를 통해 예산 추적이 매우 쉬워집니다.
Moz API 백링크 가격 책정과 비교할 때 구조가 다릅니다. Ahrefs는 월 $129부터 시작하는 구독 내에 200,000 유닛을 판매하는 반면, 여기서는 선불 잔액에서 호출당 비용을 지불합니다.
단계별 구독 tiers가 없으며 월 최소 사용량도 없습니다. 선불 잔액 방식이므로 초과 요금이 발생하지 않습니다. 모든 경우에 동일한 규칙이 적용됩니다. 월 1회 실행되는 스크립트든 모든 클라이언트 온보딩 시 실행되는 스크립트든 동일한 규칙으로 요금이 부과됩니다. 신규 가입자는 무료 크레딧 $100로 시작하며, 이는 약 500,000회의 2크레딧 호출에 충분합니다.
예상치 못한 오류 없이 첫 스크립트 작성하기
작게 시작하세요. API를 호출하는 스크립트는 작성하기 간단하지만 예상보다 많은 비용이 발생할 수 있습니다. 아래 규칙들은 첫 번째 버전이 합리적으로 유지되도록 도와줍니다.
첫 실행은 하나의 도메인으로 제한하세요. 출력이 의도한 대로 나오면 목록을 단계별로 확장하고, 각 단계 사이에 잔액을 확인하세요.
페이지는 비용의 단위입니다
한 번의 호출은 반환된 행의 수에 관계없이 한 번만 청구됩니다. 가져온 페이지는 또 다른 호출이므로, 큰 목록을 페이지네이션할 때마다 페이지당 한 번의 요금이 부과됩니다.
어떤 사이트가 2,500개의 참조 도메인을 가지고 있고 모두 조회하고 싶다고 가정해 보세요. 선택한 페이지 크기에 따라 이는 여러 번의 호출이 필요하며, 각 호출에는 고유의 비용이 발생합니다. 루프를 시작하기 전에 페이지 수를 세세요. 질문의 성격에 맞는 페이지 크기를 선택하세요. 짧은 목록은 한 번의 호출로 충분하지만, 긴 목록은 각 페이지마다 동일한 주의가 필요합니다.
모든 응답에서 크레딧 확인하기
모든 인증된 응답에는 _credits 필드가 포함되어 호출 비용과 남은 잔액을 나타냅니다. 머리속으로 추정한 숫자가 아니라 이 필드를 로그에 기록하세요.
잔액을 출력에 기록하는 스크립트를 사용하면 긴 실행 전에 계정이 고갈되기 전에 중단할 수 있습니다. 확인 과정을 간단하고 명확하게 유지하세요.
무료 호출을 사용하여 계획 테스트하기
domain, overview, stats, suggest는 키가 필요 없으며 비용이 없습니다. 유료 호출이 실행되기 전에 도메인 철자 확인 및 데이터의 기본 구조를 확인하는 데 사용하세요.
그런 다음 유료 호출을 추가하세요. 같은 도메인을 대상으로 한 번에 하나씩 추가하세요. 무료 호출에서 잡힌 실수는 비용이 들지 않습니다. 무료 출력물을 유료 출력물과 동일한 날짜 폴더에 보관하세요.
무료 및 1크레딧 동작
| 동작 | 비용 | 용도 |
|---|---|---|
| domain | 무료 | 빠른 DR 조회, 홈페이지 체크커의 백엔드 호출 |
| overview | 무료 | 도메인의 주요 지표 |
| stats | 무료 | 인덱스 자체에 대한 수치 |
| suggest | 무료 | 도메인의 자동완성 스타일 조회 |
| bulk_dr | 1크레딧 | 호출당 최대 2,000개 도메인, domains= GET 또는 POST 본문 사용 |
| compare | 1크레딧 | 최대 20개 도메인 비교 |
| top | 1크레딧 | 우리 인덱스의 순위 목록 |
| dr_distribution | 1크레딧 | 세트 전반에 걸친 DR 분포 |
| tld_breakdown | 1크레딧 | TLD별 참조 사이트 그룹화 |
2크레딧 및 3크레딧 동작
| 동작 | 비용 | 용도 |
|---|---|---|
| refdomains | 2크레딧 | 대상 사이트에 링크하는 도메인 |
| backlinks | 2크레딧 | 개별 링크 |
| anchors | 2크레딧 | 앵커 텍스트 목록 |
| toppages | 2크레딧 | 링크를 유도하는 페이지 |
| anchor_cloud | 2 크레딧 | 사용 빈도에 따라 가중치가 부여된 앵커 텍스트 |
| 교차 분석 | 2 크레딧 | 한 번에 2~10개 도메인에 링크를 걸고 있는 사이트 (교체 링크 탐색용) |
| 검색 | 3 크레딧 | 앵커 텍스트, 제목, URL 전체 텍스트 검색 |
| 키워드 | 3 크레딧 | 정확한 앵커 텍스트로 링크된 사이트 |
호출 횟수는 행 수와 무관하게 1회로 청구되며, 최대 1,000개의 행을 반환합니다. 결과를 탐색하려면 page와 per(10~5000)를 사용하고, sort와 order=asc|desc를 사용하여 정렬합니다. 심층 페이지네이션은 50,000에서 중단됩니다.
발생할 수 있는 오류
| HTTP 코드 | 의미 | 해결 방법 |
|---|---|---|
| 401 | 키 누락 또는 유효하지 않음 | key 파라미터 또는 헤더 확인 |
| 402 | 크레딧 소진 | 계정 페이지에서 USDT(TRC-20)로 충전 |
호출 실패 시 및 첫 번째 확인 사항
실제 실패 사례의 대부분은 두 가지 오류로 설명됩니다. 각 오류마다 해결 방법이 다르므로 다른 변경을 하기 전에 코드를 먼저 확인하세요.
실패한 호출에서도 유용한 정보를 얻을 수 있습니다. 키 값을 제거한 후 요청 URL, 시간 및 응답 본문을 로그에 기록하세요.
401은 키가 승인되지 않았음을 의미합니다
401 응답은 키가 누락되었거나 유효하지 않음을 나타냅니다. 해결책은 데이터가 아닌 요청에 있습니다. key 파라미터 또는 Bearer 헤더를 확인하고 값이 전체 복사되었는지 확인하세요. 디버깅 중 키를 출력하지 마세요.
스크립트가 로컬에서는 작동하지만 서버에서는 실패하는 경우가 있습니다. 서버에서 401 오류가 발생하면 해당 머신에 환경 변수가 설정되지 않았기 때문일 수 있습니다.
402는 잔액 소진을 의미합니다
402 응답은 크레딧이 모두 소모되었음을 의미합니다. 데이터에 문제가 없으며, 동일한 호출을 다시 시도해도 충전 전까지는 동일한 오류가 발생합니다.
충전은 계정 페이지에서 TRC-20 네트워크의 USDT로 이루어집니다. 긴 실행 전에 잔액을 확인하여 스크립트가 목록 중간에 중단되지 않도록 하세요. 경계 임계값도 설정하세요. 조기 경고가 중단된 감사보다 훨씬 저렴하기 때문입니다.
낭비 없는 재시도
변경될 수 있는 오류(예: 시간 초과)만 재시도하세요. 401 또는 402 오류를 무한 루프로 재시도하면 로그에 노이즈가 추가되고 감사 데이터에는 아무런 도움이 되지 않습니다.
시도 간에 일시 정지하고, 실패한 도메인을 별도 목록에 저장하여 의도적으로 다시 실행할 수 있도록 하세요. 스크립트 상단에 재시도 규칙을 주석으로 작성하여 다음 수정 시 유지되도록 하세요.
복구 질문에 대한 적절한 작업
보유한 질문에 답할 수 있는 가장 저렴한 호출을 선택하세요.
피해 규모는 어느 정도인가?
overview(무료)로 시작하세요. 그런 다음 refdomains를 한 번 실행하고 지난달에 저장한 파일과 비교하세요. 우리의 월간 루틴에서 차이점을 확인할 수 있습니다.
저품질 링크는 어떻게 생겼는가?
anchors와 anchor_cloud를 사용하세요. 여러 도메인에서 반복되는 이상한 단어가 패턴을 형성합니다. 이 패턴을 잡은 후 디스어보이 신화를 확인하세요.
어떤 도네이터를 추적할 가치가 있는가?
intersect는 두 개에서 열 개까지의 도메인을 받아 여러 도메인에 링크하는 사이트를 반환합니다. 경쟁사를 입력하여 당신을 건너뛰는 도네이터를 찾고, bulk_dr로 목록을 평가하세요.
이전 과정에서 링크가 유출되었는가?
구 도메인과 신 도메인 모두에 대해 toppages를 실행하면 링크가 어디에 도달하는지 확인할 수 있습니다. 마이그레이션 가이드에서 단계별로 사용합니다.
네 번의 호출로 수행하는 일회성 감사
이 순서는 유료 호출을 최소화하고 각 호출을 특정 질문에 연결합니다. 도메인당 한 번 실행한 후, 동일한 설정으로 매달 유료 호출을 반복하세요.
무료 호출 실행
overview와 domain으로 시작하세요. 둘 다 무료이며, 그 출력 결과는 이후 모든 유료 호출의 규모를 결정합니다.
참조 도메인 추출
refdomains를 호출당 2 크레딧에 사용하세요. 먼저 페이지 수를 세고 필요한 수를 결정하세요.
앵커 텍스트 혼합 비율 확인
anchors 또는 anchor_cloud를 각각 2 크레딧에 실행하세요. 여러 도메인에서 반복되는 이상한 단어를 찾아보세요.
후보 목록 평가
의심스러운 도메인을 bulk_dr에 입력하세요. 호출당 1 크레딧이며 최대 2,000개의 도메인을 처리합니다. 점수를 참조 도메인과 같은 파일에 저장하세요.
주석이 달린 페이지네이션 호출
액션 이후의 모든 파라미터는 선택 사항입니다.
curl "https://backlinkphoenix.com/api.php?action=toppages&q=yourshop.com&page=2&per=500&order=desc&key=sk_live_..."
# q: the domain; page and per: paging; order: asc or desc; key: your secret
# every response includes ok, and authenticated ones add _creditsMoz API 백링크 대안과의 공정한 비교
공정한 비교는 동일한 단위로 시작해야 합니다. 가격 페이지는 단위를 숨기는 경우가 많으므로 총액을 비교하기 전에 각 답변에 대해 실제로 지불하는 금액을 기록하세요.
Ahrefs의 단위는 구독 요금제 내에 포함되어 있으며, 월 $129부터 시작하여 200,000개의 단위를 제공합니다. 각 요청에는 최소 50개의 단위가 사용됩니다. 이것이 핵심입니다. 이를 호출당 가격과 나란히 비교해야 의미가 있습니다.
비교 테스트
알려진 크기의 도메인 5개를 선택하고 두 서비스 모두에 동일한 질문을 실행하세요. 감탄하는 기능이 아니라 필요한 답변을 비교하세요.
한 서비스는 한 번의 호출로 참조 도메인을 반환하고 다른 서비스는 세 번이 필요하다고 가정해 보세요. 이때 총 가격보다 답변당 비용이 더 중요합니다.
동일한 단위의 가격 책정
모든 항목을 답변당 비용으로 변환하세요. 우리의 호출은 크레딧당 $0.0001에 가격 책정되므로, 2 크레딧 호출은 $0.0002가 들며 무료 호출은 비용이 없습니다. 월간 실행에 7개의 크레딧이 사용된다고 가정하면 $0.0007이며, 센의 10분의 1 미만입니다.
실패한 호출 후 재실행과 같은 낭비 비용을 포함하세요. 자주 실패하는 저렴한 호출이 한 번에 작동하는 비싼 호출보다 더 비쌀 수 있습니다.
풀 스위트가 여전히 우위를 점하는 영역
키워드 연구, 랭킹 추적 및 일일 크롤링은 이 API 외부에 있습니다. 이러한 질문이 있다면 풀 스위트가 더 나은 답변을 제공하며, 비교 시 이를 명시해야 합니다.
링크 프로필의 변화와 더 주의 깊게 살펴볼 가치가 있는 도네이터를 파악하는 데 이 원장을 사용하세요. 키보드 데이터가 없다는 등 한계를 메모에 명시하여 다음 사용자가 원장이 모든 것을 커버한다고 오해하지 않도록 하세요.
