---
title: 제공되는 데이터 종류 및 API 버전 정보
description: "**데이터 구분** : API의 레벨별 깊이에 따라 Essential API, Intelligence API의 주요 카테고리로 나뉩니다. **제공 데이터 및 기능**: 각 API 카테고리가 제공하는 데이터의 주요 특징과 목적은 다음과 같습니다. 1. **Essential API**: 의도 및 소비자 행동에 기반한 가공된 고품질 데이터를 제공합니다.…"
url: "https://kr.listeningmind.com/data-api/listeningmind-daas-introduction/listeningmind-daas-data-api/"
updated: "2026-10-16"
category: 리스닝마인드 DaaS 소개
---

# 제공되는 데이터 종류 및 API 버전 정보

**데이터 구분** : API의 레벨별 깊이에 따라 Essential API, Intelligence API의 주요 카테고리로 나뉩니다.

**제공 데이터 및 기능**: 각 API 카테고리가 제공하는 데이터의 주요 특징과 목적은 다음과 같습니다.

1. **Essential API**: 의도 및 소비자 행동에 기반한 가공된 고품질 데이터를 제공합니다.
2. **Intelligence API**: 독점적인 분석과 심층적인 인사이트 추출을 위한 고부가가치 데이터를 제공합니다.

**주요 API**: 카테고리별 API 엔드포인트는 다음과 같습니다.

1. **Essential API**: 키워드 상세 정보(/keyword_info), 연관 및 확장 키워드 탐색(/intent_finder/keyword_list, /cluster_finder/keyword_list)과 같은 가공된 데이터를 제공합니다.
2. **Intelligence API**: 고객의 실제 검색 경로 분석(/path_finder) 및 관계 분석/의도 클러스터링(/cluster_finder)과 같은 심층 인사이트 분석을 위한 데이터를 제공합니다.

**API 버전 정보** : listeningmind-data-api (v0.0.20) 

## **리스닝마인드 DaaS API 구성   **

| **구분** | **제공 데이터 및 기능** | **주요 API** |
| --- | --- | --- |
| Essential API | 의도/소비자 행동 기반 고품질 데이터 제공 | **Single Processed Data - 단일 결과 데이터, 1:1 구조)** /keyword_info (검색량(average/total), 증감율(trend), 광고 정보(CPC, competition), 검색 의도(intents), 검색결과 특성(features), 유저 특성(demography), 구글/네이버 월별 검색량 상세(monthly_volume) **Multiple Processed Data - 복수 결과 데이터, 1:N 구조)** /intent_finder/keyword_list (연관 키워드 탐색) /cluster_finder/keyword_list (확장 키워드 탐색) /path_finder/keyword_list (전후 키워드 탐색) |
| Intelligence API | 독점적 분석 및 인사이트 추출을 위한 고부가가치 데이터 제공 | **Deep Insight Data - 심층 소비자 인사이트 기능)** /path_finder (고객 실제 행동/의도 파악) /cluster_finder (관계 분석/클러스터링) |

- **Single Processed Data (단일 결과 가공 데이터):**자체 수집한 원본 데이터를 분석/가공하여, 키워드의 상세 지표(Intents, demography 등)를 구조화된 데이터(JSON)으로 제공합니다.
- **Multiple Processed Data (복수 결과 가공 데이터):**검색 API와 같이 하나의 입력값에 대해 다수의 결과값(List)을 반환하는 2차 가공 데이터입니다. 
- **Deep Insight Data (심층 소비자 인사이트 - 핵심 기능):**리스닝마인드의 독점적 알고리즘을 적용, 인사이트 추출을 위해 정제/분석한 고부가가치 데이터를 구조화된 데이터(JSON) 형태로 제공합니다. 

---

## **Essential API**

- **타겟**: SEO 전문가, 콘텐츠 마케터, 브랜드 전략가
- **목적 : 시장과 소비자에 대한 의도(Intent)와 맥락(Context)를 해석**하는 핵심 데이터를 제공합니다. 수천 개의 연관 키워드로부터 소비자 관심 토픽 분류, 검색결과 상위 노출 콘텐츠 특징 분석, 소비자 의도에 최적화된 콘텐츠를 생성할 수 있도록 정보를 제공합니다.  
- **데이터****제공** : 제공되는 데이터는 마케팅 및 비즈니스 전략 수립에 핵심적인 다음과 같은 데이터 포인트를 포함합니다.
  - **키워드 목록 조회**
    1. **연관 키워드** **추출** : 인텐트 파인더 기준 키워드 목록 추출
       intent_finder/keyword_list는 특정 키워드와 **연관성이 높은 다른 키워드들을 찾아주는 기능**입니다. 즉, 사람들이 검색할 때 함께 고려하거나 자주 조합하는 키워드를 발굴하는 데 사용됩니다.
       예시: 자장면, 짜장면, 짜장면 맛집, 짜장면 레시피 등 
    2. **확장 키워드 추출 :**클러스터 파인더 기준 키워드 목록 추출
       cluster_finder/keyword_list는 특정 키워드와 소비자 검색 행동 사이의 관계 네트워크를 분석하여 더 넓은 주제 클러스터로 확장된 키워드를 발굴하는 데 사용됩니다.
       예시: 자장면, 짜장면, 짜장면 맛집, 짬뽕, 탕수육, 중국집 등
    3. **전후 키워드 추출** : 패스 파인더 기준 키워드 목록 추출
       path_finder/keyword_list는 특정 키워드 전후 경로 내 모든 키워드를 추출하는 데 사용됩니다.
       예시: 자장면, 짬뽕, 짜장면, 짬뽕 만들기, 짬뽕 맛집, 탕수육, 탕수육 만들기, 탕수육 소스 만들기
  - **검색량 (Volume)**
    1. 월 평균 검색량 (volume_avg)
    2. 최근 12개월 총 검색량 (volume_total)
    3. 최근 3개월간 증감율 (volume_trend: 상승/하락 여부)
  - **광고 관련 데이터**
    1. 경쟁도 (competition): 해당 키워드의 광고 경쟁 수준 (LOW, MEDIUM, HIGH)
    2. 경쟁 지수 (competition_index): 수치화된 경쟁 강도
    3. 클릭당 비용 (CPC, Cost Per Click)
    4. 입찰가 범위 (low_bid_micros ~ high_bid_micros)
  - **검색어 특징**
    1. 검색 결과 특성(Features): 노출된 Organic SERP Features 목록
    2. 검색 의도(Intents): 정보형(Informational), 이동형(Navigational), 상업형(Commercial), 거래형(Transactional) 
    3. 유저 특성(Demography): 연령, 성별 분포 등 검색 비중(%) 
  - **플랫폼별 월별 검색량 상세 :** 최대 48개월 제공
    1. 구글 검색량 (gg_volume_avg, gg_volume_total, gg_volume_trend)
    2. 네이버 검색량 (nv_volume_avg, nv_volume_total, nv_volume_trend)

---

### Keyword_info API (/keyword_info)

개별 키워드에 대한 **검색량, 광고 경쟁도, 클릭 단가(CPC), 트렌드 변화(증감율), 검색 의도(Intent), 검색 결과 노출 특징(SERP Features), 유저 특성(Demography)**등 상세 정보를 종합적으로 조회하는 API입니다. 

| **항목** | **주요 내용** |
| --- | --- |
| **API 목적** | 개별 키워드에 대한 **검색량, 광고 경쟁도, 클릭 단가(CPC), 트렌드 변화(증감율), 검색 의도(Intent), 유저 특성(Demography)**까지 한 번에 제공하는 '복합 데이터 API' |
| **상세 데이터** | **Ads 정보** (검색량 평균 및 합계, 증감율, CPC, 광고경쟁도), **Organic SERP Feature**별 노출 개수, **Intent** (정보형, 이동형, 상업형, 거래형), **Demography** (유저 특성 및 비율), **월별 검색량** (최대 48개월, 구글/네이버/총합)  |
| **주요 입력값** | - **조회 키워드** : 복수 입력 가능 (가능 범위: ~1,000개까지)- **기준 국가**(gl) : "kr" "jp" "us" 한정 |

### 연관 키워드 탐색 : Intent_finder/keyword_list API (/intent_finder/keyword_list)

### 확장 키워드 탐색 : Cluster_finder/keyword_list API  (/cluster_finder/keyword_list)

### 전후 키워드 탐색 : Path_finder/keyword_list API  (/path_finder/keyword_list)

시드 키워드를 포함하는, **특정 검색 의도, 경로 및 관계 네트워크를 공유하는 연관 키워드 그룹**을 찾아주는 API입니다. 리스닝마인드 SaaS '인텐트파인더/클러스터파인더/패스파인더 검색'과 같은 기능입니다. (단, 키워드별 상세 정보는 /keyword_info API를 별도 호출해야 합니다) 

| **항목** | **주요 내용** |
| --- | --- |
| **API 목적** | 단순 관련어가 아닌, 시드 키워드를 포함하며 **특정 검색 의도, 경로 및 관계 네트워크를 공유하는 연관 키워드**를 검색 (인텐트파인더, 클러스터파인더, 패스파인더 검색) |
| **상세 데이터** | 일반적인 키워드 제안 기능과 달리, 고가치 기능인 '**특정 검색 의도를 공유하는 키워드 그룹**'을 찾아줍니다. 결과는 월평균 검색량 기준으로 정렬됩니다.  [키워드 배열] |
| **주요 입력값** | - **조회 키워드 :** 복수 입력 가능 (가능 범위: 개수 제한 없음) - **기준 국가**(gl) : "kr" "jp" "us" 한정 **- 검색량 임계값(**volume_threshold) :  최소 검색량 기준 출력 제한 설정 가능 (기본값: 100) - **최대 결과 개수**(limit) : 최대 10,000개까지 출력 (기본값: 100) - **정렬 기준** : "volume_avg"(월평균 검색량) "volume_total"(연간 검색량/최근 12개월 합계) "volume_trend"(증감율/최근 3개월 기준) "cpc"(클릭당 단가) "competition_index" (광고 경쟁도) (기본값 : "volume_avg") - **정렬 순서** : "desc"(내림차순) "asc"(오름차순) (기본값 : “desc”) |

---

## **Intelligence API**

고객의 실제 검색 경로 분석(/path_finder) 및 관계 분석/의도 클러스터링(/cluster_finder)과 같은 리스닝마인드 독점 알고리즘에 기반한 데이터로서 단순 데이터 조회가 아닌, **방대한 데이터를 실시간으로 연산하고 분석**하는 '심층 분석' 기능을 제공합니다. 시장과 소비자에 대한 핵심 분석은 물론 시장 기회 발굴과 다각도 전략 수립에 필수적인 고부가가치 API입니다. 

- **타겟**: 시장 기회 발굴 및 전략 수립을 위해 심층 인사이트가 필요한 전략 분석가, AI 기반의 비즈니스 예측 모델에 독점적 고부가가치 데이터를 활용하려는 개발자 및 데이터 사이언티스트
- **목적 :** 사용자 요청에 따라 방대한 데이터를 **실시간으로 연산하고, 관계를 분석하며, 그룹화**하는 독점적 가치를 제공합니다. 이를 통해 시장 트렌드, 잠재 니즈에 대한 **심층적인 통찰력**을 제공하고, 잠재적 기회와 위협 요인에 대한 **비즈니스 예측, 위기 감지, 전환 가능성** 등  분석에 필요한 다각적인 데이터 인사이트를 제공합니다.
- **데이터****제공** :
  - **검색 경로(path) 데이터 :**특정 키워드 입력 이전/이후 사용자가 검색한 키워드들의 순서화된 배열(Sequence)
    1. **이전 경로 흐름**: 냉장 → 냉장고 → LG 냉장고
       → 사용자가 **일반 카테고리 → 브랜드 제품**으로 검색을 세분화
    2. **브랜드 연계 흐름**:
       "lg 냉장고" → "서비스센터" → "서비스 센터/홈페이지" 등
       → **AS·고장 관련 정보 검색 흐름 강함**
  - **커뮤니티(communities) 분석 :**키워드 관계 기반 클러스터 커뮤니티 조회 기능으로**검색 의도나 주제를 공유하는 키워드들의 집합**
  - **노드 간 연결 (rels) 분석 :**두 개의 키워드로 이루어진 배열의 리스트로 키워드와 키워드 사이의 직접적인 연결 관계를 나타냅니다. 

### Path_Finder API (/path_finder)

| **항목** | **주요 내용** |
| --- | --- |
| **API 목적** | 검색 경로(연관 키워드 시퀀스) 조회, 사용자가 특정 검색 주제에 대해 탐색하는 '여정'을 시퀀스(경로) 형태로 보여줍니다. |
| **상세 데이터** | 각 배열은 개별 사용자가 특정 시점이나 기간에 걸쳐 검색한 경로를 나타내며, **사용자의 검색 의도가 어떻게 변화하고 심화되는지**를 파악하는데 사용 [키워드들의 순서화된 배열(Sequence)] |
| **주요 입력값** | - **조회 키워드 :** 단수 입력- **기준 국가(**gl): "kr" "jp" "us" 한정**- 시점**(time_point): curr(현재), 3m(3개월 전), 6m(6개월 전), 9m(9개월 전), 12m(12개월 전) (기본값: curr)- **최대 결과 개수**(limit) : 최대 1,000개까지 출력 (기본값 : 300) |

### Cluster_Finder API (/cluster_finder)

| **항목** | **주요 내용** |
| --- | --- |
| **API 목적** | 키워드 관계 기반 클러스터 커뮤니티 조회, 특정 주제에 대해 갖는 **집단적인 관심사를 파악**할 수 있습니다.  |
| **상세 데이터** | **검색 의도나 주제를 공유하는 키워드들의 집합** 클러스터 그룹 (communities) : 키워드들의 배열을 값으로 가지는 JSON 객체. 각 키워드 그룹은 숫자로 된 키(예: "1", "2")로 구분 **키워드와 키워드 사이의 직접적인 연결 관계** node 간 연결 (rels) : 두 개의 키워드로 이루어진 배열(["키워드 A", "키워드 B"])의 리스트 |
| **주요 입력값** | - **조회 키워드** : 단수 입력 - **기준 국가**(gl):  "kr" "jp" "us" 한정 **- 시점**(time_point): curr(현재), 3m(3개월 전), 6m(6개월 전), 9m(9개월 전), 12m(12개월 전) (기본값: curr) - **확장 단계 범위**(hop) : 1,2,3 (기본값: 2) - **확장 방향**(orientation): "UNDIRECTED" "NATURAL" "REVERSE" (기본값: "UNDIRECTED") - **최대 결과 개수**(limit) : 최대 10,000개까지 출력 (기본값 : 500) - **응답 옵션**(response option): "communities"(커뮤니티) "rels"(관계) "all" (기본값: "communities") |