콘텐츠 리서치 워크플로우
YepAPI 엔드포인트를 사용하여 트렌드 및 감정 데이터로 콘텐츠를 기획합니다.
사용되는 엔드포인트
| 엔드포인트 | 비용 | 목적 |
|---|---|---|
POST /v1/seo/trends | $0.02 | Google 트렌드 관심도 변화 (최대 5개 키워드) |
POST /v1/seo/keywords/ideas | $0.03 | 시드 키워드로부터 키워드 제안 |
POST /v1/seo/keywords | $0.15 | 벌크 키워드 메트릭 (검색량, CPC, 난이도) |
POST /v1/seo/ai/chatgpt | $0.05 | 특정 질의에 대한 ChatGPT의 응답 |
POST /v1/seo/ai/gemini | $0.05 | 특정 질의에 대한 Gemini의 응답 |
워크플로우
1단계: 트렌드 확인
주제 키워드로 POST /v1/seo/trends를 실행합니다.
{
"keywords": ["콘텐츠 마케팅", "AI 콘텐츠", "SEO 전략"]
}
반환: 각 키워드에 대한 시간별 관심도 — 계절적 패턴과 떠오르는 주제를 발견합니다.
2단계: 콘텐츠 앵글 발견
시드 키워드로 POST /v1/seo/keywords/ideas를 실행합니다.
{
"keyword": "콘텐츠 마케팅",
"location": "us"
}
반환: 고려하지 못했을 수 있는 키워드 제안 — 각각이 잠재적인 콘텐츠 앵글입니다.
3단계: 키워드 평가
발견된 키워드로 POST /v1/seo/keywords를 실행합니다.
{
"keywords": ["콘텐츠 마케팅 전략", "콘텐츠 마케팅 예시", "콘텐츠 마케팅 ROI"],
"location": "us"
}
반환: 검색량, CPC, 키워드 난이도, 검색 의도, 12개월 트렌드.
4단계: AI 가시성 확인
POST /v1/seo/ai/chatgpt와 POST /v1/seo/ai/gemini를 실행하여 AI가 해당 주제에 대해 무엇을 말하는지 확인합니다.
{
"query": "최고의 콘텐츠 마케팅 전략"
}
반환: 각 LLM이 현재 말하는 내용 — 주제에 대한 AI 환경을 이해하는 데 유용합니다.
5단계: 콘텐츠 브리프 작성
콘텐츠 브리프로 정리합니다:
- 타겟 키워드 — 가장 기회가 큰 것 (검색량 대비 난이도)
- 지원 키워드 — 포함할 관련 용어
- 트렌드 방향 — 상승, 안정 또는 하락
- AI 환경 — LLM이 현재 말하는 내용, 채워야 할 공백
규칙
- 트렌드 데이터는 계절적 패턴을 보여줍니다 — 다가올 피크를 확인하세요
- AI 가시성 확인은 LLM이 현재 주제에 대해 말하는 내용을 알려줍니다 (AI SEO에 유용)
- 키워드 아이디어는 고려하지 못했을 수 있는 콘텐츠 앵글을 제공합니다
- 키워드에 확정하기 전에 항상 난이도를 확인하세요 — 신규 사이트의 경우 DR 80 이상은 피하세요
에러 처리
NO_CREDITS(402) — 사용자에게 https://yepapi.com/dashboard 에서 크레딧을 추가하라고 알리세요UPSTREAM_ERROR(502) — 한 번 재시도하고, 다시 실패하면 해당 단계를 건너뛰고 기록하세요VALIDATION_ERROR(400) — 키워드 형식을 확인하세요. 키워드는 비어 있지 않은 문자열이어야 합니다RATE_LIMITED(429) — 대기 후 재시도하세요.Retry-After헤더를 준수하세요