關鍵字研究工作流程
專用的關鍵字研究工作流程 — 使用 YepAPI 端點來發掘、評估與排序關鍵字。
使用的端點
| 端點 | 費用 | 用途 |
|---|---|---|
POST /v1/seo/keywords/ideas | $0.03 | 從種子關鍵字取得關鍵字建議 |
POST /v1/seo/keywords/related | $0.03 | 取得種子關鍵字的相關關鍵字 |
POST /v1/seo/keywords | $0.15 | 批量取得關鍵字指標（搜尋量、每次點擊成本、難度、意圖） |
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"
}
回傳：搜尋量、每次點擊成本、關鍵字難度、搜尋意圖（資訊型/商業型/交易型）、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標頭