---
title: 광고·키워드 입찰 도구 연동 제안
description: "Proposal 02키워드 추가 제안 · 시즌 예산 배분 [01 콘텐츠·AEO/GEO·SEO 도구](https://kr.listeningmind.com/data-api/proposal/proposal-content/)[02 광고·키워드 입찰 도구](https://kr.listeningmind.com/data-api/proposal/proposal-ads/)[03 커머스 상품기획·리뷰 분석](https://kr.listeningmind.com/data-api/proposal/proposal-commerce/)[04 소셜 리스닝·트렌드 플랫폼](https://kr.listeningmind.com/data-api/proposal/proposal-listening/)[05 리서치·설문·AI 리서치](https://kr.listeningmind.com/data-api/proposal/proposal-research/)[06 플랫폼 파트너 인사이트](https://kr.listeningmind.com/data-api/proposal/proposal-platform/)[07 마케팅 AI 에이전트·코파일럿](https://kr.listeningmind.com/data-api/proposal/proposal-agent/) **광고 계정 밖의 검색 수요로 다음 키워드를 고릅니다**광고 계정 성과 데이터에는 이미…"
url: "https://kr.listeningmind.com/data-api/proposal/proposal-ads/"
updated: "2026-10-19"
category: 도입 제안
tags:
  - AI Agent Ground Truth
  - API 연동
  - 데이터 API
  - 리스닝마인드 DaaS
  - 리스닝마인드 DaaS API 활용법
  - 키워드 조회
---

# 광고·키워드 입찰 도구 연동 제안

Proposal 02키워드 추가 제안 · 시즌 예산 배분 [01 콘텐츠·AEO/GEO·SEO 도구](https://kr.listeningmind.com/data-api/proposal/proposal-content/)[02 광고·키워드 입찰 도구](https://kr.listeningmind.com/data-api/proposal/proposal-ads/)[03 커머스 상품기획·리뷰 분석](https://kr.listeningmind.com/data-api/proposal/proposal-commerce/)[04 소셜 리스닝·트렌드 플랫폼](https://kr.listeningmind.com/data-api/proposal/proposal-listening/)[05 리서치·설문·AI 리서치](https://kr.listeningmind.com/data-api/proposal/proposal-research/)[06 플랫폼 파트너 인사이트](https://kr.listeningmind.com/data-api/proposal/proposal-platform/)[07 마케팅 AI 에이전트·코파일럿](https://kr.listeningmind.com/data-api/proposal/proposal-agent/)

**광고 계정 밖의 검색 수요로 다음 키워드를 고릅니다**광고 계정 성과 데이터에는 이미 집행한 키워드만 나옵니다. 리스닝마인드 DaaS API는 **아직 집행하지 않은 연관 검색어와 그 월 검색량·추이**를 돌려줘, 키워드 추가 제안과 시즌별 예산 배분에 계정 밖 근거를 더합니다.

 [테스트 Key 문의](https://www.listeningmind.com/ko/daas?inquiry=open)[요금 자세히](https://kr.listeningmind.com/data-api/pricing/)[API 자세히](https://kr.listeningmind.com/data-api/api-reference/)

### 이런 서비스에 맞습니다

- **검색광고 자동입찰·운영 자동화 솔루션**키워드 추가 추천 로직에 계정 밖 연관 검색어와 월 검색량·CPC·광고 경쟁도를 입력으로 더할 수 있습니다.
- **여러 매체 성과를 모아 보는 광고 대시보드**계정 성과 옆에 같은 키워드의 월별 검색량 추이를 겹쳐, 성과 변화와 수요 변화를 함께 볼 수 있게 합니다.
- **키워드 후보와 광고 문안을 만들어 주는 광고 AI**함께 검색되는 검색어 묶음을 근거로 광고그룹을 나누고, 묶음별 문안 소재를 고를 수 있습니다.

### 비어 있는 자리

> 키워드 추가 제안이 계정 안 성과에서만 나오면 집행해 본 적 없는 수요는 제안 대상에 오르지 않습니다. 계정 밖 연관 검색어를 넣으면 제안 범위가 넓어집니다.

## 계정 안 데이터로는 다음 키워드가 보이지 않는 이유

광고 계정에는 집행한 키워드의 노출·클릭·전환이 쌓입니다. 집행해 본 적 없는 검색어에는 성과 데이터가 없으므로, 계정 성과만으로 추천하면 다음 후보가 이미 집행 중인 키워드 주변에 머물기 쉽습니다. 시즌 예산도 지난 성과를 기준으로만 나누면 아직 집행하지 않은 시즌 수요는 반영되지 않습니다.

리스닝마인드 DaaS API는 계정과 무관하게 검색 데이터에서 후보를 만들고, 각 후보에 수요와 비용 신호를 붙입니다.

- **후보** — `intent_finder`가 기준 검색어와 함께 검색되는 연관 검색어를 돌려줍니다.
- **수요·비용 신호** — `keyword_info`가 월 검색량과 월별 추이, CPC(USD), 광고 경쟁도(0~100), 입찰가 하한·상한을 돌려줍니다.
- **그룹 구성** — `cluster_finder`의 검색어 묶음을 캠페인·광고그룹 단위로 옮깁니다.
- **집행 전 확인** — `serp`로 검색결과 화면 구성을, `keyword_info`의 `f_ads_top`·`f_ads_bottom`으로 광고 노출 개수를 확인합니다.

## 연동 지점 — 서비스 작업 흐름 예시

| 서비스 단계 | 붙는 데이터 | API | 호출 1건 크레딧 |
| --- | --- | --- | --- |
| 신규 키워드 후보 발굴 | 기준 검색어와 함께 검색되는 연관 검색어 목록 | `intent_finder` | 30 + 반환 2/개 |
| 후보 거르기 · 시즌 예산 배분 | 검색어별 월 검색량·월별 추이·CPC·광고 경쟁도 | `keyword_info` | 10 / 키워드 |
| 캠페인 · 광고그룹 구성 | 함께 검색되는 검색어 묶음과 묶음 사이 관계 | `cluster_finder` | 150 + 반환 50/개 |
| 집행 전 검색결과 화면 확인 | 해당 검색어의 현재 검색결과 화면 구성 | `serp` | 30 / 키워드 |

## 단계별 연동 상세

### ① 신규 키워드 후보 발굴 — `POST /intent_finder/keyword_list`

시드 검색어(최대 100개)를 넣으면 함께 검색되는 연관 검색어를 검색량 순으로 돌려줍니다. 주요 파라미터는 `limit`(기본 100, 최대 10,000), `sort`(`volume_avg` 기본, `volume_total`·`volume_trend`·`cpc`·`competition_index` 선택), `volume_threshold`(기본 100 — 이 검색량 미만은 제외)입니다.

- `sort`를 `cpc`나 `competition_index`로 바꾸면 클릭 단가순·경쟁도순으로 후보를 받을 수 있습니다. 계정에 이미 있는 키워드를 빼고 보여주면 "계정 밖 후보" 목록이 됩니다.
- 시드를 여러 개 넣으면 시드별 결과가 아니라 하나로 합쳐진 목록이 돌아옵니다. 시드별로 나눠 보여주려면 시드마다 따로 호출합니다.
- 시드 자신이나 관련이 약한 검색어가 섞일 수 있어, 호출 후 서비스 쪽에서 한 번 거르는 것을 권장합니다.

### ② 후보 거르기 · 시즌 예산 배분 — `POST /keyword_info`

검색어를 한 번에 최대 1,000개까지 넣어 지표를 받습니다. `data_type`과 관계없이 키워드당 10크레딧이므로, `all`로 한 번에 받아 필요한 필드만 쓰는 편이 효율적입니다.

- `cpc`는 USD 기준이고, `competition`은 LOW(0~33)·MEDIUM(34~66)·HIGH(67~100)로 나뉩니다. 입찰가 하한·상한(`low_bid_micros`·`high_bid_micros`)은 micros 단위(1,000,000 = 1 USD)입니다.
- `monthly_volume`의 월별 값으로 시즌 피크 월을 표시하면, 지난 집행 이력이 없는 키워드도 시즌 예산 배분 근거를 가질 수 있습니다.
- `volume_avg`(최근 3개월 평균)·`volume_total`(최근 12개월 합)·`volume_trend`(3개월 전 대비 증감률). `gl`이 `kr`일 때는 구글과 네이버 합산값이며, 채널별 수치는 `gg_`·`nv_` 접두 필드로 받습니다.
- `monthly_volume` — 최대 48개월 월별 검색량(`data_type`이 `ads_info` 또는 `all`일 때 반환).

### ③ 캠페인 · 광고그룹 구성 — `POST /cluster_finder`

기준 검색어 하나를 넣으면 함께 검색되는 검색어 묶음(`communities`)과 검색어 사이 연결(`rels`)을 돌려줍니다. `hop`은 관계를 몇 단계까지 넓힐지 정하며 기본값은 2입니다(1은 직접 연관, 3은 탐색용으로 결과와 비용이 크게 늘어납니다). `limit` 기본값은 500입니다.

- 묶음 하나를 광고그룹 하나로 두고, 묶음 안 검색어를 그룹 키워드 후보로 제안할 수 있습니다.
- 묶음 구조 없이 키워드 목록만 필요하면 `/cluster_finder/keyword_list`(30 + 반환 2/개)로 먼저 받고, 깊게 볼 시드에만 본 API를 쓰면 비용을 줄일 수 있습니다.
- `orientation`(무방향·순방향·역방향)을 바꿔 호출하면 각각 따로 과금됩니다.

### ④ 집행 전 검색결과 화면 확인 — `POST /serp`

검색어 하나의 최근 수집된 구글 검색결과 스냅샷을 화면 노출 순서대로 블록 배열로 돌려줍니다. `num`(10 또는 20, 기본 20)과 `features`(블록 타입 1개 필터)를 지정할 수 있고, 모바일 검색결과 기준입니다. 필터를 걸어도 과금은 같으므로 여러 블록이 필요하면 필터 없이 한 번에 받습니다.

- 검색결과 화면에 광고가 몇 개 노출되는지는 `keyword_info`의 `f_ads_top`·`f_ads_bottom`으로, 그 아래 AI Overview·오가닉 블록 순서는 `serp`로 확인합니다.
- 실시간 크롤링이 아니라 수집된 스냅샷입니다. 화면에는 응답의 `collected_at`을 함께 표기합니다.
- 초당 3회 호출 제한이 있습니다. `sequence`는 페이지 전체 노출 순서, `position`은 오가닉 결과 안 순위입니다.

## 예시 흐름 — 시드 검색어 "lg 냉장고"

아래는 통합 가이드(API v0.0.60)에 실린 호출 예시를 광고 작업 흐름 순서로 엮은 것입니다. 수치는 호출 시점에 따라 달라집니다.

```
POST /keyword_info
{
  "keywords": ["lg 냉장고"],
  "gl": "kr",
  "data_type": "all"
}
```

- 실제데이터 광고 경쟁도 HIGH(`competition_index` 100), CPC 0.79 USD, 월평균 검색량 51,866건, 증감률 0.4.
- 실제데이터 입찰가 하한 101,487 micros, 상한 1,410,134 micros.
- 추정 micros를 달러로 환산하면 하한 약 0.10 USD, 상한 약 1.41 USD입니다.
- 실제데이터 이 스냅샷의 `f_ads_top`은 0이었습니다.

**연관 검색어** (`intent_finder`, limit 5) — lg 김치냉장고, lg 냉장고 4 도어, lg냉장고 2도어, lg 디오스 냉장고가 돌아왔습니다.

이 예시에서는 도어 수(4 도어·2도어)와 제품 라인(디오스·김치냉장고)이 연관 검색어에 함께 나타났습니다. 광고 AI라면 이 축으로 광고그룹을 나누는 안을 제안할 수 있습니다.

**검색어 묶음** (`cluster_finder`, hop 1 · limit 10) — 가장 큰 묶음에 삼성 냉장고, lg 냉장고 사이즈, lg 냉장고 1등급, lg 냉장고 4 도어, lg 소형 냉장고 가격·추천, 컨버터블 냉장고 단점이 함께 묶였습니다.

## 비용 계산 예시

운영 솔루션이 광고주 1곳의 시드 50개를 월 1회 갱신하는 상황을 가정한 계산입니다. 반환 결과가 가정한 수량만큼 채워졌다고 보고 계산했으며, 실제 과금은 각 응답의 `cost_detail`을 따릅니다.

| 단계 | 가정 | 크레딧 계산 | 크레딧 |
| --- | --- | --- | --- |
| 신규 후보 발굴 | 시드 50개 × 각 200개 반환 | 50 × (30 + 200 × 2) | 21,500 |
| 후보 거르기 | 후보 검색어 2,000개 | 2,000 × 10 | 20,000 |
| 광고그룹 구성 | 핵심 시드 5개 × 각 100개 반환 | 5 × (150 + 100 × 50) | 25,750 |
| 검색결과 확인 | 집행 예정 검색어 100개 | 100 × 30 | 3,000 |
| **합계** |  |  | **70,250** |

추정 70,250크레딧 × 1.3원 = 약 91,325원(데이터 사용료, VAT 별도). 광고주 수에 비례해 늘어나므로, 광고주 공통 카테고리 시드는 한 번 받아 여러 계정에 재사용하는 설계가 유리합니다. 자세한 규칙은 [비용 계산 예시](https://kr.listeningmind.com/data-api/pricing/cost-examples/)와 [크레딧 산정 기준](https://kr.listeningmind.com/data-api/pricing/credit-and-endpoint-pricing/)을 참고하세요.

## 연동 방식

- **REST API** — Base URL `https://listeningmind-data-api.ascentlab.io`, 요청 헤더 `LM-API-KEY`로 인증합니다. 서비스 백엔드에서 정기 수집·적재할 때 씁니다.
- **MCP Server** — `https://listeningmind-daas-mcp.ascentlab.io`(OAuth). 광고 AI가 문안이나 키워드를 제안하는 대화 중에 직접 조회하게 할 때 씁니다. 플랫폼별 설정은 [연동하기](https://kr.listeningmind.com/data-api/connect/)를 참고하세요.
- **`user_query`** — AI 기능을 거친 호출이라면 사용자의 질문 원문을 함께 보낼 수 있습니다. 호출 이력에만 적재되고 과금과 반환 데이터에는 영향이 없습니다.
- **오류 과금** — 4xx·5xx 오류 응답은 입력·출력 모두 과금되지 않습니다.
- **사용량 관리** — `GET /usage/summary`로 기간별 호출수·에러율·사용 크레딧을 조회해 내부 대시보드에 적재할 수 있습니다(크레딧 미차감).

## 데이터를 보여줄 때 유의할 점

- **국가 단위** — 검색량·관계·이슈 인덱스는 모두 `gl`(`kr`·`jp`·`us`) 기준으로 산출됩니다. 한 국가 결과로 다른 국가를 추론하지 않습니다.
- **검색량 채널** — `gl`이 `kr`일 때만 구글과 네이버 합산값이고, 일본·미국은 구글 단독 수치입니다.
- **검색결과 시점** — 검색결과 화면은 실시간이 아니라 수집된 스냅샷입니다. "현재 검색결과"가 아니라 "`collected_at` 기준 스냅샷"으로 표기합니다.
- **빈 결과** — 빈 배열은 "데이터 없음"이지 "수요 없음"이 아닙니다.
- **값의 출처 구분** — API가 돌려준 값과 그 값을 계산해 만든 값(비중·합계 등)을 구분해 표기하면 리포트를 검증하기 쉬워집니다.

## 함께 보면 좋은 문서

- [고관여 타겟 키워드 선점](https://kr.listeningmind.com/data-api/usecase/standard-jobs-j6/) — 검색 데이터로 선점할 키워드를 고르는 표준 작업
- [신규 카테고리 기회 탐색](https://kr.listeningmind.com/data-api/usecase/standard-jobs-j1/) — 아직 경쟁이 적은 수요를 찾는 방법
- [연관 쿼리 추출 API 활용 가이드](https://kr.listeningmind.com/data-api/api-reference/intent-finder-api/) · [키워드 조회 API 활용 가이드](https://kr.listeningmind.com/data-api/api-reference/keyword-info-api/)
- [관계 네트워크 분석 API 활용 가이드](https://kr.listeningmind.com/data-api/api-reference/cluster-finder-api/) · [검색결과 조회 API 활용 가이드](https://kr.listeningmind.com/data-api/api-reference/serp-api/)

호출 1건 크레딧은 공개 요금표 기준입니다. '반환 N/개'는 응답에 돌아온 항목(검색어·경로 속 검색어·이슈) 1개마다 더해지는 크레딧입니다. 1크레딧은 공개 요금표 기준 1.3원입니다. 반환 수가 기준 검색어마다 달라 월 사용량은 테스트 Key 실측으로 확인합니다. 검색량 조회 크레딧은 전체 지표를 받는 기준입니다. 검색결과 화면 조회 크레딧은 공개 요금표에 실측 전 기본값으로 표기돼 있어 바뀔 수 있습니다.

READY TO START

시장과 소비자 신호를, 지금 AI 파이프라인에 연결하세요.

스킬팩 다운로드부터 엔터프라이즈 API 키 발급까지, 담당 엔지니어가 직접 안내합니다.

[전문가와 상담하기 →](https://www.listeningmind.com/ko/daas?inquiry=open)[요금 보기](https://kr.listeningmind.com/data-api/pricing/)