경쟁사 리서치 워크플로우
YepAPI 엔드포인트를 사용한 도메인 간 경쟁 분석입니다.
사용된 엔드포인트
| 엔드포인트 | 비용 | 목적 |
|---|---|---|
POST /v1/seo/domain/overview | $0.01 | 트래픽, 키워드, 백링크, 도메인 순위 |
POST /v1/seo/competitors | $0.04 | 키워드 중복을 기준으로 한 SEO 경쟁사 도메인 |
POST /v1/seo/keyword-gap | $0.04 | 두 도메인 간 키워드 격차 분석 |
워크플로우
1단계: 도메인 개요
사용자의 도메인에 대해 POST /v1/seo/domain/overview를 실행합니다.
{
"domain": "example.com"
}
반환값: 유기적 트래픽, 총 키워드, 백링크 수, 도메인 순위.
2단계: 경쟁사 발견
사용자의 도메인에 대해 POST /v1/seo/competitors를 실행합니다.
{
"domain": "example.com"
}
반환값: 키워드 중복 비율과 트래픽 추정치를 포함한 경쟁사 도메인.
3단계: 상위 경쟁사 비교
상위 2-3개 경쟁사에 대해 각각 POST /v1/seo/domain/overview를 실행합니다.
{
"domain": "competitor.com"
}
비교 항목: 트래픽, 키워드 수, 백링크 프로필, 도메인 순위.
4단계: 키워드 격차 분석
사용자의 도메인과 상위 경쟁사 간에 POST /v1/seo/keyword-gap을 실행합니다.
{
"domain": "example.com",
"competitor": "competitor.com"
}
반환값: 경쟁사가 순위에 오르지만 사용자가 그렇지 않은 키워드 — 검색량과 난이도별로 정렬됨.
5단계: 결과 제시
- 전체적으로 누가 더 우위에 있는지 (트래픽, 권위)
- 키워드 격차가 어디에 있는지 (사용자가 놓치고 있는 고가치 용어)
- 다음에 타겟팅할 항목 (기회 우선순위: 높은 검색량 + 낮은 난이도)
규칙
- 도메인 개요부터 시작 — $0.01로 가장 저렴하며 기준 지표를 제공합니다.
- 경쟁사 심층 분석은 최대 3개로 제한 — 비용을 통제합니다.
- 키워드 격차 분석이 가장 실행 가능한 결과물입니다 — 항상 포함하십시오.
오류 처리
NO_CREDITS(402) — 사용자에게 https://yepapi.com/dashboard 에서 크레딧을 추가하라고 알립니다.UPSTREAM_ERROR(502) — 한 번 재시도합니다. 다시 실패하면 해당 단계를 건너뛰고 메모합니다.VALIDATION_ERROR(400) — 도메인 형식을 확인합니다. 프로토콜 없이 베어 도메인을 사용합니다.RATE_LIMITED(429) — 대기 후 재시도합니다.Retry-After헤더를 준수합니다.