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

데이터 구분 : API의 레벨별 깊이에 따라 Standard 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 – 단일 결과 데이터)keyword_info (검색량(average/total), 증감율(trend), 광고 정보(CPC, competition), 검색 의도(intents), 검색결과 특성(features), 유저 특성(demography), 구글/네이버 월별 검색량 상세(monthly_volume) Multiple Processed Data – 복수 결과 데이터)intent_finder/keyword_list (연관 키워드 탐색)cluster_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는 특정 키워드와 소비자 검색 행동 사이의 관계 네트워크를 분석하여 더 넓은 주제 클러스터로 확장된 키워드를 발굴하는 데 사용됩니다.
       예시: 자장면, 짜장면, 짜장면 맛집, 짬뽕, 탕수육, 중국집 등
  • 검색량 (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)

시드 키워드를 포함하는, 특정 검색 의도 및 관계 네트워크를 공유하는 연관 키워드 그룹을 찾아주는 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”)