데이터 API 문서
메인 페이지에서 옮긴 개발 참고 자료입니다. 테스트 키와 코드 예시, 엔드포인트마다 받는 값, 9개 엔드포인트의 리마 단가와 계산식, 시장별 데이터, 데이터 출처를 한곳에 모았습니다.
쓰는 방법
API, MCP, Skill 모두 같은 리스닝마인드 검색 데이터를 씁니다. 방식을 바꿔도 숫자는 같습니다.
REST로 검색량, 함께 찾는 말, 검색 경로, 의도 군집, AI 개요를 받습니다. 대시보드, 추천, 광고 자동화, 자사 AI 서비스에 바로 씁니다.
POST /v1/path_finder
Authorization: Bearer $LM_API_KEY
{"keyword": "로봇청소기",
"market": "kr"}
→ 그 검색의 앞뒤로 이어진 실제 경로주소 하나를 커넥터에 넣으면, 일상 언어로 물을 때 AI가 알맞은 도구를 불러 실제 검색 데이터로 답합니다.
{
"mcpServers": {
"listeningmind": {
"url": "https://daas.listeningmind.ai/mcp"
}
}
}스킬은 AI에게 어떤 순서로 데이터를 불러와 어떤 목차로 정리할지 알려 주는 지침 파일입니다. 숫자는 데이터에서만 가져옵니다.
"선크림 시장에서 사람들이 사기 전에 무엇을 피하는지 정리해줘" → lm-non-customer 스킬이 토픽 데이터를 불러와 같은 목차로 보고
대량 적재(ETL)나 서버 직접 연동(S2S)이 필요하면 데이터 API 서포트로 맞춤 연동합니다. 마케터는 코드 없이 앱에서 바로 쓸 수 있습니다.
개발자
이 사이트의 REST와 MCP를 매달 무료 한도로 씁니다. 계약 전에 응답 형식과 품질을 직접 확인하세요.
서포트(계약)로 대량 연동할 때는 전용 주소(listeningmind-data-api.ascentlab.io)와 계약 키로 같은 데이터를 대량으로 부릅니다. 귀사 키워드로 하는 검증 테스트는 도입 상담에서 준비해 드립니다.
curl -X POST https://daas.listeningmind.ai/v1/keyword_info \
-H "Authorization: Bearer $LM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords": ["제습기"], "market": "kr"}'import os, requests
r = requests.post("https://daas.listeningmind.ai/v1/cluster_finder",
headers={"Authorization": f"Bearer {os.environ['LM_API_KEY']}"},
json={"keyword": "선크림", "market": "jp"})
print(r.json())# 키 없이, 무료로: 실행 전에 비용 확인
curl -X POST https://daas.listeningmind.ai/v1/estimate_cost \
-H "Content-Type: application/json" \
-d '{"tool": "path_finder", "arguments": {"keyword": "러닝화", "market": "us"}}'엔드포인트
기업 계약 Data API는 https://listeningmind-data-api.ascentlab.io에 JSON으로 POST 요청하고, LM-API-KEY 헤더로 인증합니다. 시장은 gl로 지정하며(kr, us, jp), 요청 한 번에 한 시장을 조회합니다. 이 사이트의 테스트 키로는 /v1/ 아래 같은 이름으로 부릅니다.
| 엔드포인트 | 하는 일 | 단가 | 예시와 계산식 |
|---|---|---|---|
/keyword_info키워드 지표 | 검색량·CPC·경쟁도·SERP 요소·성별·연령 | 키워드 100개당 13리마 | 키워드 1,000개130리마13,000원= 1,000개 × 100개당 13리마 |
/serp검색 결과 페이지 | 키워드의 검색 결과 페이지(JSON) | 키워드 100개당 39리마 | 키워드 100개39리마3,900원= 100개 × 100개당 39리마 |
/intent_finder/keyword_list연관 검색어 | 시드를 포함한 연관 검색어, 검색량순 | 호출당 1리마 + 결과 1,000개당 26리마 | 시드 1개 → 연관어 500개14리마1,400원= 호출 1리마 + 결과 500개 × 1,000개당 26리마 |
/path_finder검색 경로 | 키워드 전후로 실제 이어진 검색 순서 | 호출당 1리마 + 결과 1,000개당 520리마 | 시드 1개 → 경로 키워드 300개157리마15,700원= 호출 1리마 + 결과 300개 × 1,000개당 520리마 |
/path_finder/keyword_list경로 키워드 목록 | 경로에 나온 키워드만 | 호출당 1리마 + 결과 1,000개당 26리마 | 시드 1개 → 키워드 300개9리마900원= 호출 1리마 + 결과 300개 × 1,000개당 26리마 → 1리마 단위 올림 |
/cluster_finder구매 상황 군집 | 같은 의도의 검색 묶음과 관계 네트워크 | 호출당 2리마 + 결과 1,000개당 650리마 | 시드 1개 → 군집 키워드 500개327리마32,700원= 호출 2리마 + 결과 500개 × 1,000개당 650리마 |
/cluster_finder/keyword_list군집 키워드 목록 | 관계 네트워크의 키워드만 | 호출당 1리마 + 결과 1,000개당 26리마 | 시드 1개 → 키워드 500개14리마1,400원= 호출 1리마 + 결과 500개 × 1,000개당 26리마 |
/trend_finder/issue_list이슈 키워드 | 매일 갱신되는 이슈와 원문 링크 | 호출당 1리마 + 결과 1,000개당 26리마 | 시드 1개 → 이슈 100개4리마400원= 호출 1리마 + 결과 100개 × 1,000개당 26리마 → 1리마 단위 올림 |
ai_overview구글 AI 개요 | MCP로 제공 · AI 개요 본문과 인용 출처 | 건당 2리마 | 10건20리마2,000원= 10건 × 건당 2리마 |
오류 응답(4xx·5xx)은 과금하지 않고, 결과가 빈 정상 응답은 호출당 금액만 냅니다. 호출 한 번의 금액은 표의 단가로 계산해 1리마 단위로 올립니다. 크레딧 환산: 외부 과금 문서와 데이터 API 사용량 리포트는 아직 크레딧 단위입니다. 1,000크레딧 = 13리마 = 1,300원으로 바꾸고 호출당 금액을 1리마로 올리면 이 표와 같습니다.
시장별 제공 범위
| 데이터 | 한국gl=kr | 미국 베타gl=us | 일본gl=jp |
|---|---|---|---|
| 검색량, CPC, 경쟁도 | 구글 + 네이버엔진별·합산 모두 제공 | 구글 | 구글 |
| 검색 경로와 구매 상황 | 제공 | 제공 | 제공 |
| 검색자 성별·연령 | 제공 | 미제공 | 미제공 |
| 일간 이슈 인덱스 | 제공 | 제공 | 제공 |
| 검색 결과 페이지와 AI 개요 | 제공 | 제공 | 제공 |
한국 검색의 상당 부분은 네이버에서 일어납니다. 구글만 보는 도구로는 한국 수요의 일부만 보입니다. 리스닝마인드는 두 엔진의 검색량을 따로, 그리고 합산해서 제공합니다.
데이터 출처
법무·데이터 담당자가 가장 먼저 묻는 내용입니다. 요약은 아래와 같고, 상세 방법론은 요청 시 제공합니다.
세 시장 모두 구글 검색 데이터, 한국은 네이버를 더합니다. 최근 3개월 평균, 12개월 합계, 월별 검색량을 제공합니다.
검색 경로와 연관 검색 관계로 이어진 검색을 묶고, 구매 맥락과 카테고리 진입 상황(CEP)으로 이름을 붙입니다.
2025년 5월 26일부터 구글 자동완성과 검색 결과로 매일 구축합니다. 이슈마다 원문 링크가 붙습니다.
최근 12개월 동안 수집한 검색 결과 스냅샷입니다. 항목마다 수집일이 표시됩니다.
모든 결과는 집계된 검색 데이터입니다. 개인을 식별할 수 있는 정보는 응답에 들어 있지 않습니다.