# BizSpring AIR™ API 소개 — BizSpring AIR™ API

>  description: BizSpring AIR™ 광고 데이터 API와 리포팅 API 시작 가이드입니다. REST API 인증, JSON 요청 방식, 주요 사용 흐름을 안내합니다. BizSpring AIR™ API 소개 BizSpring AIR™ API 시작 가이드 BizSpring 

## 핵심 요약


---
description: >-
  BizSpring AIR™ 광고 데이터 API와 리포팅 API 시작 가이드입니다. REST API 인증, JSON 요청 방식, 주요 사용
  흐름을 안내합니다.
---

# BizSpring AIR™ API 소개

## BizSpring AIR™ API 시작 가이드

### BizSpring AIR™ 란?

**BizSpring AIR™** (Ad Intelligence Report)는 비즈스프링이 제공하는 **광고 매체 통합 리포팅 솔루션**입니다.

네이버, 카카오, 구글, 메타(Facebook/Instagram), 크리테오, 틱톡 등 국내외 주요 광고 플랫폼의 성과 데이터를 단 **1회 계정 연동**만으로 매일 자동으로 수집·통합하여, 하나의 통합 리포트로 제공합니다.

> 💡 **한 줄 요약**: 여러 광고 매체를 일일이 접속하지 않아도, AIR™ 하나로 전체 광고 성과를 한눈에 파악할 수 있습니다.

### AIR™ 의 핵심 가치

#### ① 멀티 매체 통합

광고주나 에이전시가 관리하는 **모든 광고 매체의 성과 데이터**를 통합합니다.

* 키워드 검색광고: 네이버 SA, 카카오 키워드, 구글 Ads
* 디스플레이/SNS: 메타, 카카오모먼트, 네이버 GFA, 크리테오, 틱톡, 데이블 등

#### ② 자동 리포팅

매일 아침, 전일자 광고 성과 데이터가 **자동으로 취합·가공**되어 제공됩니다.

* 일·주·월 단위 정기 리포트 스케줄링
* 이메일 / 슬랙 등 자동 발송

#### ③ 데이터 결합 분석

광고 매체 성과 데이터 + 비즈스프링 LOGGER™ 행동 데이터를 결합하여 더욱 정밀한 성과 분석이 가능합니다.

#### ④ Growth Platform™ 연계

AIR™ 는 비즈스프링 Growth Platform™ (오픈형 CDP)의 핵심 모듈로:

* 고객 여정 전체 분석
* 타겟 오디언스 세그먼트 생성
* AI 기반 캠페인 최적화 와 연계할 수 있습니다.

### AIR™ API 란?

AIR™ API는 플랫폼에서 수집·가공된 **통합 광고 성과 데이터를 외부 시스템에서 직접 조회**할 수 있도록 제공되는 RESTful API입니다.

| 기존 방식                | AIR™ API 활용                |
| -------------------- | -------------------------- |
| 각 매체별 API 토큰 발행 필요   | ✅ AIR™ 토큰 하나로 모든 매체 데이터 조회 |
| 매체마다 다른 데이터 구조 파악 필요 | ✅ 통합된 공통 지표와 차원 체계         |
| 개발자 인력 투입 및 유지보수 부담  | ✅ 비즈스프링이 매체 API 변경사항 관리    |
| 매체별 데이터를 직접 가공·병합    | ✅ 가공·병합 완료된 데이터를 바로 수신     |

### 주요 활용 사례

* 맞춤형 광고 성과 대시보드 구축 (Looker Studio, Tableau, Power BI 등)
* 사내 보고서 자동화 (Google Sheets, Slack 봇 등)
* AI/ML 모델 입력 데이터 파이프라인
* 내부 데이터(매출, 주문)와의 결합 분석

### 지원 광고 매체

| 구분         | 지원 매체                                   |
| ---------- | --------------------------------------- |
| 검색광고 (SA)  | 네이버 검색광고, 카카오 키워드광고, 구글 Ads             |
| 디스플레이 (DA) | 네이버 GFA, 카카오모먼트, 메타, 크리테오, 틱톡, 데이블, 모비온 |

### 비즈스프링 솔루션 생태계에서의 위치

```
Growth Platform™ (오픈형 CDP)
├── AIR™     ← 광고 매체 성과 통합 리포팅 (이 문서)
├── LOGGER™  ← 웹/앱 사용자 행동 분석
├── TAM™     ← 타겟 오디언스 세그먼트 추출
├── CXM™     ← 마케팅 캠페인 자동화
└── ADMonster™ ← 키워드 자동입찰 관리
```



### 기술 구성

API는 [REST](https://ko.wikipedia.org/wiki/REST) 방식으로 동작합니다. 응답 데이터는 [JSON](https://ko.wikipedia.org/wiki/JSON) 형식으로 제공합니다.

다음과 같은 용도에 적합합니다.

* 광고 매체별 리포팅 데이터 자동 수집
* 사내 대시보드 및 데이터 파이프라인 연동
* 통합 광고 성과 리포트 생성

<div data-full-width="false"><figure><img src="https://3087586734-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUJ9uzvHT9r6QImnjP8p4%2Fuploads%2Fl5ZB54iXRruZRqcwl2c2%2FAIR-Architecture.png?alt=media&#x26;token=26c98ff6-ee23-4c99-ac6b-175c22425c21" alt="BizSpring AIR™"><figcaption><p>BizSpring AIR™</p></figcaption></figure></div>

{% hint style="info" %}
웹사이트에서 BizSpring AIR™ 서비스의 전반적 기능을 확인할 수 있습니다.

[BizSpring AIR™ 웹사이트 바로가기](https://growthplatform.ai/gmp/prd_air.php)
{% endhint %}

### API 사용 준비하기

BizSpring AIR™ API를 처음 사용하는 경우 아래 순서로 진행합니다.

{% content-ref url="../getting-started/api" %}
[api](../getting-started/api)
{% endcontent-ref %}

{% content-ref url="../getting-started/growth-platform-tm" %}
[growth-platform-tm](../getting-started/growth-platform-tm)
{% endcontent-ref %}

### 이미 API 사용 권한이 있는 경우

이미 BizSpring AIR™ API 계정을 보유한 경우 아래 문서에서 **인증 토큰 발급**, **리포팅 API 요청**, **메타데이터와 코드값**을 확인합니다.

{% content-ref url="../bizspring-air-tm-api-spec./auth-token" %}
[auth-token](../bizspring-air-tm-api-spec./auth-token)
{% endcontent-ref %}

{% content-ref url="../bizspring-air-tm-api-spec./air-tm-reporting-api" %}
[air-tm-reporting-api](../bizspring-air-tm-api-spec./air-tm-reporting-api)
{% endcontent-ref %}

{% content-ref url="../bizspring-air-tm-api-spec./metadata-code" %}
[metadata-code](../bizspring-air-tm-api-spec./metadata-code)
{% endcontent-ref %}


## FAQ


---
출처: https://bizspring.ai/kb/ref/manual/bizspring-air-api-bizspring-air-api-소개 · 최종 갱신 2026-08-23T14:32:38.444294+00:00
