로컬 SEO 워크플로우
YepAPI 엔드포인트를 통해 Google Maps 및 로컬 SERP 데이터를 활용한 로컬 비즈니스 리서치
사용된 엔드포인트
| 엔드포인트 | 비용 | 목적 |
|---|---|---|
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"
}
반환: 로컬 검색량, CPC, 난이도 — 로컬 키워드는 검색량이 낮으나 의도(intent)가 높음
4단계: 온페이지 감사
사용자 사이트에서 POST /v1/seo/page-audit 실행
{
"url": "https://example-plumber.com"
}
로컬 SEO 신호 확인: 구조화된 데이터(LocalBusiness 스키마), NAP 일관성, 메타 태그 내 위치 키워드
5단계: 결과 제시
- 로컬 경쟁사 환경 (평점, 리뷰 수, 순위)
- 키워드 기회 (검색량과 난이도를 포함한 로컬 용어)
- 온페이지 수정 사항 (구조화된 데이터 누락, NAP 불일치, 메타 태그 간격)
규칙
- Maps 쿼리에는 항상 위치 포함 — 결과는 위치에 따라 다름
- 로컬 SEO에서 NAP 일관성은 매우 중요 — 불일치 시 플래그 표시
- Google Maps 결과에는 평점, 리뷰 수, 카테고리가 포함됨 — 경쟁사 벤치마킹에 활용
- 로컬 키워드는 검색량이 낮지만 의도가 높음 — 전환 가능성 우선시
에러 처리
NO_CREDITS(402) — 사용자에게 https://yepapi.com/dashboard에서 크레딧을 추가하도록 안내UPSTREAM_ERROR(502) — 한 번 재시도; 다시 실패하면 해당 단계를 건너뛰고 기록VALIDATION_ERROR(400) — 쿼리 형식 확인; 쿼리 문자열에 위치 포함RATE_LIMITED(429) — 대기 후 재시도;Retry-After헤더 준수