API 사용을 위한 순서 — BizSpring AIR™ API
핵심 요약
- 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
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
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™ 단일 토큰으로 모든 매체 조회 |
자주 묻는 질문
API를 사용하려면 가장 먼저 뭘 해야 하나요?
먼저 Growth Platform™ 계정을 생성해야 합니다. 이후 광고주 및 광고 매체 계정을 등록하는 절차가 이어집니다.
광고 매체는 어떻게 연동하나요?
매체별로 연동 방식이 다릅니다. 네이버 검색광고는 API Key/Secret Key 입력, 카카오·구글 Ads·메타는 OAuth 로그인, 모비온·데이블·ADN 등은 ID/PW 입력 방식을 사용합니다.
매체마다 토큰을 따로 발행해야 하나요?
아닙니다. AIR™는 단일 토큰으로 모든 매체를 조회할 수 있어 매체별로 별도 토큰을 발행할 필요가 없습니다.
데이터는 실시간으로 조회할 수 있나요?
실시간 조회는 지원하지 않으며, 전일 기준 일별 데이터가 매일 오전에 업데이트되어 제공됩니다.
API 호출은 어떻게 하나요?
Auth Token 발행 후 발급받은 Access Token을 Authorization 헤더에 담아 리포팅 API를 curl 등으로 호출하면 됩니다.