{
"id": "7c57515c-097b-4614-9f97-35018a98f070",
"slug": "ref/manual/bizspring-air-api-api-사용을-위한-순서",
"doc_type": "ref",
"title": "API 사용을 위한 순서 — BizSpring AIR™ API",
"title_en": null,
"one_liner": " description: BizSpring AIR™ API 사용을 위한 순서입니다. 링크를 클릭하면 상세 내용을 확인할 수 있습니다. API 사용을 위한 순서
\n\n### 전체 Flow\n\n```\n1️⃣ Growth Platform™ 계정 생성\n ↓\n2️⃣ AIR™ 광고주 및 광고 매체 계정 등록\n ↓\n3️⃣ Auth Token 발행 (API 인증 토큰)\n ↓\n4️⃣ API 호출 (리포팅 데이터 조회)\n ↓\n5️⃣ 데이터 활용 (대시보드 / 보고서 / AI 등)\n```\n\n### Step 1 — Growth Platform™ 계정 생성\n\nAIR™ API를 사용하기 위해서는 먼저 Growth Platform™ 계정이 필요합니다.\n\n### Step 2 — 광고주 및 광고 매체 계정 등록\n\n| 설정 항목 | 설명 |\n| ----------- | -------------------------- |\n| 광고주 등록 | 데이터를 조회할 광고주(브랜드/기업) 정보 등록 |\n| 광고 매체 등록 | 네이버, 카카오, 구글 등 집행 매체 등록 |\n| 광고주 ↔ 매체 연동 | 각 광고주가 집행하는 매체 연결 |\n\n매체별 연동 방식:\n\n* **API 정보 입력**: 네이버 검색광고 (API Key, Secret Key)\n* **OAuth 로그인**: 카카오, 구글 Ads, 메타\n* **ID/PW 입력**: 모비온, 데이블, ADN 등\n\n### Step 3 — Auth Token 발행\n\nbash\n\n```bash\ncurl -X POST https://api.bizspring.co.kr/air/v1/auth/token \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"client_id\": \"YOUR_CLIENT_ID\",\n \"client_secret\": \"YOUR_CLIENT_SECRET\",\n \"grant_type\": \"client_credentials\"\n }'\n```\n\n### Step 4 — API 호출\n\nbash\n\n```bash\ncurl -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\" \\\n -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```\n\n### FAQ\n\n| 질문 | 답변 |\n| ---------------- | -------------------------- |\n| 데이터 업데이트 주기 | 매일 오전, 전일 기준 데이터 업데이트 |\n| 실시간 조회 가능 여부 | 전일 기준 일별 데이터 제공, 실시간 미지원 |\n| 매체별 토큰 별도 발행 필요? | 불필요. AIR™ 단일 토큰으로 모든 매체 조회 |\n",
"related_slugs": [],
"faq": [
{
"a": "먼저 Growth Platform™ 계정을 생성해야 합니다. 이후 광고주 및 광고 매체 계정을 등록하는 절차가 이어집니다.",
"q": "API를 사용하려면 가장 먼저 뭘 해야 하나요?"
},
{
"a": "매체별로 연동 방식이 다릅니다. 네이버 검색광고는 API Key/Secret Key 입력, 카카오·구글 Ads·메타는 OAuth 로그인, 모비온·데이블·ADN 등은 ID/PW 입력 방식을 사용합니다.",
"q": "광고 매체는 어떻게 연동하나요?"
},
{
"a": "아닙니다. AIR™는 단일 토큰으로 모든 매체를 조회할 수 있어 매체별로 별도 토큰을 발행할 필요가 없습니다.",
"q": "매체마다 토큰을 따로 발행해야 하나요?"
},
{
"a": "실시간 조회는 지원하지 않으며, 전일 기준 일별 데이터가 매일 오전에 업데이트되어 제공됩니다.",
"q": "데이터는 실시간으로 조회할 수 있나요?"
},
{
"a": "Auth Token 발행 후 발급받은 Access Token을 Authorization 헤더에 담아 리포팅 API를 curl 등으로 호출하면 됩니다.",
"q": "API 호출은 어떻게 하나요?"
}
],
"jsonld": null,
"keywords": [],
"source_id": "gitbook:UJ9uzvHT9r6QImnjP8p4:xf2yvQ9S7RdeytFmOEHR",
"video_url": null,
"duration_sec": null,
"thumbnail_url": null,
"image_url": null,
"caption": null,
"solution_slug": null,
"captured_at": null,
"width": null,
"height": null,
"created_at": "2026-08-23T14:32:38.444294+00:00",
"updated_at": "2026-08-28T09:46:06.925+00:00",
"visibility": "public",
"source_stage": "1",
"anonymized": true,
"source_key": "gitbook-manuals",
"origin": "ingest",
"locked": false,
"locked_by": null,
"locked_at": null,
"gate_state": {
"g1": {
"hits": [],
"pass": true
},
"g2": {
"pass": false,
"total": 25,
"issues": [
"숫자·규격 같은 검증 가능한 구체가 부족합니다",
"다른 문서와 겹치는 말이 대부분입니다",
"핵심 요약 불릿이 3개 미만입니다",
"Q&A 쌍이 3개 미만입니다"
],
"applies": true
},
"g3": {
"pass": true,
"required": false
},
"stage": "1",
"decided_at": "2026-08-23T14:32:37.773Z"
},
"raw_id": "c33bf7e8-67bf-4739-a30a-93a3bdf15bef",
"search_text": "API 사용을 위한 순서 — BizSpring AIR™ API description: BizSpring AIR™ API 사용을 위한 순서입니다. 링크를 클릭하면 상세 내용을 확인할 수 있습니다. API 사용을 위한 순서
\n\n### 전체 Flow\n\n```\n1️⃣ Growth Platform™ 계정 생성\n ↓\n2️⃣ AIR™ 광고주 및 광고 매체 계정 등록\n ↓\n3️⃣ Auth Token 발행 (API 인증 토큰)\n ↓\n4️⃣ API 호출 (리포팅 데이터 조회)\n ↓\n5️⃣ 데이터 활용 (대시보드 / 보고서 / AI 등)\n```\n\n### Step 1 — Growth Platform™ 계정 생성\n\nAIR™ API를 사용하기 위해서는 먼저 Growth Platform™ 계정이 필요합니다.\n\n### Step 2 — 광고주 및 광고 매체 계정 등록\n\n| 설정 항목 | 설명 |\n| ----------- | -------------------------- |\n| 광고주 등록 | 데이터를 조회할 광고주(브랜드/기업) 정보 등록 |\n| 광고 매체 등록 | 네이버, 카카오, 구글 등 집행 매체 등록 |\n| 광고주 ↔ 매체 연동 | 각 광고주가 집행하는 매체 연결 |\n\n매체별 연동 방식:\n\n* **API 정보 입력**: 네이버 검색광고 (API Key, Secret Key)\n* **OAuth 로그인**: 카카오, 구글 Ads, 메타\n* **ID/PW 입력**: 모비온, 데이블, ADN 등\n\n### Step 3 — Auth Token 발행\n\nbash\n\n```bash\ncurl -X POST https://api.bizspring.co.kr/air/v1/auth/token \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"client_id\": \"YOUR_CLIENT_ID\",\n \"client_secret\": \"YOUR_CLIENT_SECRET\",\n \"grant_type\": \"client_credentials\"\n }'\n```\n\n### Step 4 — API 호출\n\nbash\n\n```bash\ncurl -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\" \\\n -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n```\n\n### FAQ\n\n| 질문 | 답변 |\n| ---------------- | -------------------------- |\n| 데이터 업데이트 주기 | 매일 오전, 전일 기준 데이터 업데이트 |\n| 실시간 조회 가능 여부 | 전일 기준 일별 데이터 제공, 실시간 미지원 |\n| 매체별 토큰 별도 발행 필요? | 불필요. AIR™ 단일 토큰으로 모든 매체 조회 |\n",
"embedding": null,
"embedded_at": null,
"embedding_hash": null,
"map_x": null,
"map_y": null,
"backlinks": [],
"html_url": "https://bizspring.ai/kb/ref/manual/bizspring-air-api-api-사용을-위한-순서",
"markdown_url": "https://bizspring.ai/kb/ref/manual/bizspring-air-api-api-사용을-위한-순서.md"
}