本地 SEO 工作流程
使用 Google Maps 與本地 SERP 資料，透過 YepAPI 端點進行本地商家研究。
使用的端點
| 端點 | 成本 | 用途 |
|---|---|---|
POST /v1/serp/google/maps | $0.01 | Google Maps / 本地商家結果 |
POST /v1/scrape | $0.01 | 擷取競爭對手網站的 NAP 資料 |
POST /v1/seo/keywords | $0.15 | 本地關鍵字指標（搜尋量、難度） |
POST /v1/seo/page-audit | $0.03 | 檢查使用者網站的本地 SEO 信號 |
工作流程
步驟 1：在地競爭者探索
使用商業類別與地點執行 POST /v1/serp/google/maps。
{
"query": "plumber in austin tx",
"location": "us"
}
回傳：本地商家清單，包含評價、評論數、類別、地址。
步驟 2：擷取 NAP 資料
對每個競爭者，在其網站上執行 POST /v1/scrape。
{
"url": "https://competitor-plumber.com",
"format": "markdown"
}
擷取 NAP（名稱、地址、電話）資料，以比較各清單間的一致性。
步驟 3：本地關鍵字研究
使用本地關鍵字執行 POST /v1/seo/keywords。
{
"keywords": ["plumber in austin", "emergency plumber austin tx", "austin plumbing service"],
"location": "us"
}
回傳：本地搜尋量、每次點擊成本、難度—本地關鍵字搜尋量較低但意圖較高。
步驟 4：頁面審查
在使用者的網站上執行 POST /v1/seo/page-audit。
{
"url": "https://example-plumber.com"
}
檢查本地 SEO 信號：結構化資料（LocalBusiness 結構化資料標記）、NAP 一致性、meta 標籤中的位置關鍵字。
步驟 5：呈現結果
- 本地競爭格局（評價、評論數、排名）
- 關鍵字機會（具搜尋量與難度的本地詞彙）
- 頁面修正（缺少結構化資料、NAP 不一致、meta 標籤缺口）
規則
- 在 Maps 查詢中務必包含地點 — 結果依地點而定
- NAP 一致性對本地 SEO 至關重要 — 標記不一致處
- Google Maps 結果包含評價、評論數與類別 — 用於競爭者基準比較
- 本地關鍵字搜尋量較低但意圖較高 — 優先考慮轉換潛力
錯誤處理
NO_CREDITS(402) — 告訴使用者前往 https://yepapi.com/dashboard 加值點數UPSTREAM_ERROR(502) — 重試一次；若再次失敗，跳過該步驟並記錄VALIDATION_ERROR(400) — 檢查查詢格式；在查詢字串中納入地點RATE_LIMITED(429) — 等待並重試；遵守Retry-After標頭