검색 경로 내 키워드 추출 API(/path_finder/keyword_list)는 /path_finder와 동일한 요청 구조를 가지지만, 반환 형식이 다릅니다. 검색 경로 시퀀스(string[][]) 대신 경로에 등장하는 키워드 목록(string[])만을 반환합니다. 경로 상세 구조 분석 전에 키워드 풀을 빠르게 확보하거나, Path Finder 호출 비용을 절감하고 싶을 때 활용합니다.
/path_finder vs /path_finder/keyword_list 비교
| 구분 | /path_finder | /path_finder/keyword_list |
| 반환 형식 | string[][] (경로 시퀀스 배열) | string[] (키워드 목록) |
| 포함 정보 | 경로 구조, 순서 정보 포함 | 키워드 목록만 (순서 정보 없음) |
| 과금 | 50 크레딧 입력 + 40 크레딧/경로 | 30 크레딧 입력 + 2 크레딧/키워드 |
| 주 활용 목적 | 검색 여정 흐름 분석 | 키워드 풀 빠른 수집 |
⚠ Path Finder List는 경로의 순서 정보를 포함하지 않습니다. “어떤 순서로 검색했는가”를 분석하려면 반드시 /path_finder를 사용하세요.
핵심 특징 요약
| 항목 | 상세 |
| 엔드포인트 | POST /path_finder/keyword_list |
| 요청 키워드 수 | 1개 (단일 키워드) |
| 반환 형식 | data: string[] (경로 등장 키워드 목록) |
| 반환 기본 개수 | 300개 |
| 반환 최대 개수 | 1,000개 (limit 기준) |
| 과금 방식 | 입력 1회당 30 크레딧 + 출력 키워드 1개당 2 크레딧 |
경로 내 모든 키워드 도출(/path_finder/keyword_list) 언제 사용 하나
| 상황 | 활용 방안 |
| /path_finder 전 사전 탐색 | 경로 키워드 목록 먼저 확인 후 필요 시 상세 경로 조회 → 비용 절감 |
| 연관 키워드 빠른 풀(Pool) 확보 | 경로 기반 키워드를 /keyword_info에 일괄 입력하여 상세 분석 |
| /intent_finder/keyword_list 보완 | Intent Finder로 확보한 키워드 외에 경로 기반 키워드 추가 |
| 키워드 커버리지 확인 | 특정 경쟁사·제품 키워드가 경로에 포함되는지 빠르게 확인 |
요청 파라미터 (Request)
파라미터 상세
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
| keyword | string | Y | – | 분석 중심 키워드 (단일 string) |
| gl | string | Y | – | 국가 코드: “kr” / “jp” / “us” |
| time_point | string | N | curr | 데이터 시점: curr / 3m / 6m / 9m / 12m |
| limit | integer | N | 300 | 반환 키워드 수 (1~1,000) |
요청 예시
기본 요청
{
"keyword": "OO 냉장고",
"gl": "kr"
}
과거 시점 키워드 수집
{
"keyword": "OO 냉장고",
"gl": "kr",
"time_point": "6m",
"limit": 500
}
응답 데이터 구조 (Response)
응답 데이터 구조 개요
| 필드 | 타입 | 설명 |
| result | string | “OK” 또는 “FAILED” |
| cost_detail | object | 입력 30 Cr + 출력 2 Cr × 반환 키워드 수 |
| remain_credits | integer | 요청 후 잔여 크레딧 |
| data | array[string] | 경로에 등장한 키워드 목록 |
응답 예시
{
"result": "OK",
"cost_detail": { "input_cost": 30, "output_cost": 60, "total_cost": 90 },
"data": [
"냉장고", "lg 냉장고 가격", "lg 냉장고 오브제",
"삼성 냉장고 비교", "lg 냉장고 후기"
]
}
과금 구조 상세
| 구분 | 기준 | 단가 | 예시 |
| 입력 과금 | 요청 1회당 | 30 크레딧 | 고정 비용 |
| 출력 과금 | 반환 키워드 1개당 | 2 크레딧 | 키워드 300개 → 600 크레딧 |
| 합계 (기본 limit: 300) | – | 630 크레딧 | 30 + 600 |
| /path_finder vs /path_finder/keyword_list 과금 비교 | |
| /path_finder (limit: 300) | 12,050 크레딧 |
| /path_finder/keyword_list (limit: 300) | 630 크레딧 |
| 절감액 | 약 11,420 크레딧 (약 95% 절감, 추정) |
✔ 경로 키워드 목록만 필요하다면 /path_finder/keyword_list를 먼저 사용하면 큰 비용 절감 효과를 얻을 수 있습니다. 이후 주요 키워드에 대한 상세 경로만 /path_finder로 조회하는 2단계 접근법을 권장합니다.
활용 시나리오
2단계 경로 분석 전략
| 단계 | 사용 API | 목적 | 비용 |
| 1단계: 키워드 풀 수집 | /path_finder/keyword_list | 경로 등장 키워드 목록 확보 | 낮음 |
| 2단계: 상세 분석 선택 | /keyword_info 또는 /path_finder | 유망 키워드 상세 지표 또는 경로 확인 | 필요한 것만 |
연계 API
| 연계 API | 활용 방법 | 얻는 인사이트 |
| /keyword_info | 수집된 키워드를 keywords[]에 일괄 입력 | 각 키워드 검색량, 의도, SERP 구조 확인 |
| /path_finder | 목록에서 핵심 키워드만 선별 후 상세 경로 분석 | 선별 키워드 중심의 정밀 여정 분석 |
| /cluster_finder | 경로 키워드를 클러스터 시드로 활용 | 경로 기반 소비자 인식 그룹화 |
자주 묻는 질문 (FAQ)
Q1. /path_finder와 /path_finder/keyword_list의 결과 키워드는 동일한가요?
동일한 파라미터로 조회 시 포함 키워드 집합은 동일합니다. 차이는 반환 형식으로, /path_finder는 경로 순서 구조를, /path_finder/keyword_list는 단순 키워드 목록을 반환합니다.
Q2. 반환된 키워드 목록에서 중심 키워드 자체도 포함되나요?
네. 경로에 중심 키워드 자체가 포함되므로, 결과 목록에도 중심 키워드가 포함될 수 있습니다.
