# API 사용을 위한 순서 — BizSpring AIR™ API

>  description: BizSpring AIR™ API 사용을 위한 순서입니다. 링크를 클릭하면 상세 내용을 확인할 수 있습니다. API 사용을 위한 순서 <table <thead <tr <th width="76.33333333333331" align="center" No.</th 

## 핵심 요약
- BizSpring AIR™ API 사용을 위해 계정 생성부터 데이터 활용까지 이어지는 전체 절차를 안내하는 문서입니다.
- Growth Platform™ 계정 생성 후 광고주 및 네이버·카카오·구글 등 광고 매체 계정을 등록해야 합니다.
- Auth Token 발행과 API 호출 예시(curl 명령)를 통해 리포팅 데이터를 조회하는 방법을 설명합니다.
- 데이터는 매일 오전 전일 기준으로 업데이트되며 실시간 조회는 지원하지 않습니다.

---
description: BizSpring AIR™ API 사용을 위한 순서입니다. 링크를 클릭하면 상세 내용을 확인할 수 있습니다.
---

# API 사용을 위한 순서

***

<table><thead><tr><th width="76.33333333333331" align="center">No.</th><th>API 사용을 위한 순서</th><th data-hidden>내용 상세</th></tr></thead><tbody><tr><td align="center">1</td><td><a href="growth-platform-tm">BizSpring AIR™ 계정 생성/확인</a></td><td></td></tr><tr><td align="center">2</td><td><a href="../bizspring-air-tm-api-spec./auth-token">Auth Token(인증 토큰) 획득</a></td><td></td></tr><tr><td align="center">3</td><td><a href="../bizspring-air-tm-api-spec./air-tm-reporting-api">BizSpring AIR™ API 의 리포팅 데이터 요청</a></td><td></td></tr></tbody></table>

### 전체 Flow

```
1️⃣ Growth Platform™ 계정 생성
        ↓
2️⃣ AIR™ 광고주 및 광고 매체 계정 등록
        ↓
3️⃣ Auth Token 발행 (API 인증 토큰)
        ↓
4️⃣ API 호출 (리포팅 데이터 조회)
        ↓
5️⃣ 데이터 활용 (대시보드 / 보고서 / AI 등)
```

### Step 1 — Growth Platform™ 계정 생성

AIR™ API를 사용하기 위해서는 먼저 Growth Platform™ 계정이 필요합니다.

### Step 2 — 광고주 및 광고 매체 계정 등록

| 설정 항목       | 설명                         |
| ----------- | -------------------------- |
| 광고주 등록      | 데이터를 조회할 광고주(브랜드/기업) 정보 등록 |
| 광고 매체 등록    | 네이버, 카카오, 구글 등 집행 매체 등록    |
| 광고주 ↔ 매체 연동 | 각 광고주가 집행하는 매체 연결          |

매체별 연동 방식:

* **API 정보 입력**: 네이버 검색광고 (API Key, Secret Key)
* **OAuth 로그인**: 카카오, 구글 Ads, 메타
* **ID/PW 입력**: 모비온, 데이블, ADN 등

### Step 3 — Auth Token 발행

bash

```bash
curl -X POST https://api.bizspring.co.kr/air/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "client_credentials"
  }'
```

### Step 4 — API 호출

bash

```bash
curl -X GET "https://api.bizspring.co.kr/air/v1/report?rpt_no=1&client_seq=123&start_date=2024-01-01&end_date=2024-01-31" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

### FAQ

| 질문               | 답변                         |
| ---------------- | -------------------------- |
| 데이터 업데이트 주기      | 매일 오전, 전일 기준 데이터 업데이트      |
| 실시간 조회 가능 여부     | 전일 기준 일별 데이터 제공, 실시간 미지원   |
| 매체별 토큰 별도 발행 필요? | 불필요. AIR™ 단일 토큰으로 모든 매체 조회 |


## FAQ
**Q. API를 사용하려면 가장 먼저 뭘 해야 하나요?**

A. 먼저 Growth Platform™ 계정을 생성해야 합니다. 이후 광고주 및 광고 매체 계정을 등록하는 절차가 이어집니다.

**Q. 광고 매체는 어떻게 연동하나요?**

A. 매체별로 연동 방식이 다릅니다. 네이버 검색광고는 API Key/Secret Key 입력, 카카오·구글 Ads·메타는 OAuth 로그인, 모비온·데이블·ADN 등은 ID/PW 입력 방식을 사용합니다.

**Q. 매체마다 토큰을 따로 발행해야 하나요?**

A. 아닙니다. AIR™는 단일 토큰으로 모든 매체를 조회할 수 있어 매체별로 별도 토큰을 발행할 필요가 없습니다.

**Q. 데이터는 실시간으로 조회할 수 있나요?**

A. 실시간 조회는 지원하지 않으며, 전일 기준 일별 데이터가 매일 오전에 업데이트되어 제공됩니다.

**Q. API 호출은 어떻게 하나요?**

A. Auth Token 발행 후 발급받은 Access Token을 Authorization 헤더에 담아 리포팅 API를 curl 등으로 호출하면 됩니다.

---
출처: https://bizspring.ai/kb/ref/manual/bizspring-air-api-api-사용을-위한-순서 · 최종 갱신 2026-08-28T09:46:06.925+00:00