키워드 리서치 워크플로우
YepAPI 엔드포인트를 이용해 키워드를 발견, 평가, 우선순위화하는 전용 키워드 리서치 워크플로우입니다.
사용되는 엔드포인트
| 엔드포인트 | 비용 | 목적 |
|---|---|---|
POST /v1/seo/keywords/ideas | $0.03 | 시드 키워드로부터 키워드 제안 |
POST /v1/seo/keywords/related | $0.03 | 시드 키워드에 대한 관련 키워드 |
POST /v1/seo/keywords | $0.15 | 대량 키워드 지표 (검색량, CPC, 난이도, 의도) |
POST /v1/seo/keyword-gap | $0.04 | 두 도메인 간 키워드 갭 분석 |
워크플로우
1단계: 키워드 아이디어 생성
시드 키워드로 시작합니다. POST /v1/seo/keywords/ideas를 실행하세요.
{
"keyword": "프로젝트 관리",
"location": "us"
}
반환값: 시드 키워드를 기반으로 한 키워드 제안 — 콘텐츠 각도와 롱테일 변형.
2단계: 관련 키워드 찾기
POST /v1/seo/keywords/related로 확장하세요.
{
"keyword": "프로젝트 관리",
"location": "us"
}
반환값: 의미적으로 관련된 용어 — 더 넓은 변형과 더 좁은 변형.
3단계: 키워드 지표 평가
모든 후보 키워드로 POST /v1/seo/keywords를 실행하세요.
{
"keywords": ["프로젝트 관리 소프트웨어", "프로젝트 관리 도구", "최고의 프로젝트 관리 앱"],
"location": "us"
}
반환값: 검색량, CPC, 키워드 난이도, 검색 의도 (정보/상업/거래), 12개월 트렌드.
4단계: 키워드 갭 분석 (선택 사항)
사용자가 도메인과 경쟁사를 가지고 있다면 POST /v1/seo/keyword-gap를 실행하세요.
{
"domain": "example.com",
"competitor": "competitor.com"
}
반환값: 경쟁사는 순위에 있지만 사용자는 없는 키워드 — 미활용 기회.
5단계: 키워드 우선순위화
기회 점수로 정렬된 우선순위 키워드 목록을 제시하세요:
- 높은 기회 — 높은 검색량 + 낮은 난이도
- 의도별 그룹화 — 정보, 탐색, 상업, 거래
- 계절성 키워드 플래그 — 트렌드 데이터에서 12개월 패턴 기록
규칙
- 아이디어로 넓게 시작한 후, 지표로 좁혀가세요
- 키워드를 검색 의도별로 그룹화: 정보, 탐색, 상업, 거래
- 트렌드 데이터(12개월 패턴)를 사용하여 계절성 키워드에 플래그를 지정하세요
- 키워드 지표 호출은 배치로 처리 — 요청당 최대 100개 키워드($0.15)가 개별 조회보다 저렴합니다
오류 처리
NO_CREDITS(402) — 사용자에게 https://yepapi.com/dashboard 에서 크레딧을 추가하라고 알리세요UPSTREAM_ERROR(502) — 한 번 재시도; 다시 실패하면 해당 단계를 건너뛰고 기록하세요VALIDATION_ERROR(400) — 키워드 형식을 확인하세요; 키워드는 비어 있지 않은 문자열이어야 합니다RATE_LIMITED(429) — 대기 후 재시도;Retry-After헤더를 존중하세요