---
title: 경로 내 모든 키워드 추출 API(/path_finder/keyword_list) 활용 가이드
description: "검색 경로 내 키워드 추출 API(/path_finder/keyword_list)는 /path_finder와 동일한 요청 구조를 가지지만, 반환 형식이 다릅니다. 검색 경로 시퀀스(string[][]) 대신 경로에 등장하는 **키워드 목록(string[])만을 반환**합니다. 경로 상세 구조 분석 전에 키워드 풀을 빠르게 확보하거나, Path Finder 호출 비용을 절감하고 싶을 때 활용합니다.…"
url: "https://kr.listeningmind.com/data-api/api-reference/paht-finder-keyword-list-api/"
updated: "2026-10-16"
category: API 레퍼런스
tags:
  - 키워드 조회
---

# 경로 내 모든 키워드 추출 API(/path_finder/keyword_list) 활용 가이드

검색 경로 내 키워드 추출 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. 반환된 키워드 목록에서 중심 키워드 자체도 포함되나요?**

네. 경로에 중심 키워드 자체가 포함되므로, 결과 목록에도 중심 키워드가 포함될 수 있습니다.