{ "id": "35956acf-4201-4bf5-95d9-2649e4a14c9f", "slug": "ref/manual/bizspring-air-api-bizspring-air-api-소개", "doc_type": "ref", "title": "BizSpring AIR™ API 소개 — BizSpring AIR™ API", "title_en": null, "one_liner": " description: BizSpring AIR™ 광고 데이터 API와 리포팅 API 시작 가이드입니다. REST API 인증, JSON 요청 방식, 주요 사용 흐름을 안내합니다. BizSpring AIR™ API 소개 BizSpring AIR™ API 시작 가이드 BizSpring ", "summary_bullets": [], "body_md": "---\ndescription: >-\n BizSpring AIR™ 광고 데이터 API와 리포팅 API 시작 가이드입니다. REST API 인증, JSON 요청 방식, 주요 사용\n 흐름을 안내합니다.\n---\n\n# BizSpring AIR™ API 소개\n\n## BizSpring AIR™ API 시작 가이드\n\n### BizSpring AIR™ 란?\n\n**BizSpring AIR™** (Ad Intelligence Report)는 비즈스프링이 제공하는 **광고 매체 통합 리포팅 솔루션**입니다.\n\n네이버, 카카오, 구글, 메타(Facebook/Instagram), 크리테오, 틱톡 등 국내외 주요 광고 플랫폼의 성과 데이터를 단 **1회 계정 연동**만으로 매일 자동으로 수집·통합하여, 하나의 통합 리포트로 제공합니다.\n\n> 💡 **한 줄 요약**: 여러 광고 매체를 일일이 접속하지 않아도, AIR™ 하나로 전체 광고 성과를 한눈에 파악할 수 있습니다.\n\n### AIR™ 의 핵심 가치\n\n#### ① 멀티 매체 통합\n\n광고주나 에이전시가 관리하는 **모든 광고 매체의 성과 데이터**를 통합합니다.\n\n* 키워드 검색광고: 네이버 SA, 카카오 키워드, 구글 Ads\n* 디스플레이/SNS: 메타, 카카오모먼트, 네이버 GFA, 크리테오, 틱톡, 데이블 등\n\n#### ② 자동 리포팅\n\n매일 아침, 전일자 광고 성과 데이터가 **자동으로 취합·가공**되어 제공됩니다.\n\n* 일·주·월 단위 정기 리포트 스케줄링\n* 이메일 / 슬랙 등 자동 발송\n\n#### ③ 데이터 결합 분석\n\n광고 매체 성과 데이터 + 비즈스프링 LOGGER™ 행동 데이터를 결합하여 더욱 정밀한 성과 분석이 가능합니다.\n\n#### ④ Growth Platform™ 연계\n\nAIR™ 는 비즈스프링 Growth Platform™ (오픈형 CDP)의 핵심 모듈로:\n\n* 고객 여정 전체 분석\n* 타겟 오디언스 세그먼트 생성\n* AI 기반 캠페인 최적화 와 연계할 수 있습니다.\n\n### AIR™ API 란?\n\nAIR™ API는 플랫폼에서 수집·가공된 **통합 광고 성과 데이터를 외부 시스템에서 직접 조회**할 수 있도록 제공되는 RESTful API입니다.\n\n| 기존 방식 | AIR™ API 활용 |\n| -------------------- | -------------------------- |\n| 각 매체별 API 토큰 발행 필요 | ✅ AIR™ 토큰 하나로 모든 매체 데이터 조회 |\n| 매체마다 다른 데이터 구조 파악 필요 | ✅ 통합된 공통 지표와 차원 체계 |\n| 개발자 인력 투입 및 유지보수 부담 | ✅ 비즈스프링이 매체 API 변경사항 관리 |\n| 매체별 데이터를 직접 가공·병합 | ✅ 가공·병합 완료된 데이터를 바로 수신 |\n\n### 주요 활용 사례\n\n* 맞춤형 광고 성과 대시보드 구축 (Looker Studio, Tableau, Power BI 등)\n* 사내 보고서 자동화 (Google Sheets, Slack 봇 등)\n* AI/ML 모델 입력 데이터 파이프라인\n* 내부 데이터(매출, 주문)와의 결합 분석\n\n### 지원 광고 매체\n\n| 구분 | 지원 매체 |\n| ---------- | --------------------------------------- |\n| 검색광고 (SA) | 네이버 검색광고, 카카오 키워드광고, 구글 Ads |\n| 디스플레이 (DA) | 네이버 GFA, 카카오모먼트, 메타, 크리테오, 틱톡, 데이블, 모비온 |\n\n### 비즈스프링 솔루션 생태계에서의 위치\n\n```\nGrowth Platform™ (오픈형 CDP)\n├── AIR™ ← 광고 매체 성과 통합 리포팅 (이 문서)\n├── LOGGER™ ← 웹/앱 사용자 행동 분석\n├── TAM™ ← 타겟 오디언스 세그먼트 추출\n├── CXM™ ← 마케팅 캠페인 자동화\n└── ADMonster™ ← 키워드 자동입찰 관리\n```\n\n\n\n### 기술 구성\n\nAPI는 [REST](https://ko.wikipedia.org/wiki/REST) 방식으로 동작합니다. 응답 데이터는 [JSON](https://ko.wikipedia.org/wiki/JSON) 형식으로 제공합니다.\n\n다음과 같은 용도에 적합합니다.\n\n* 광고 매체별 리포팅 데이터 자동 수집\n* 사내 대시보드 및 데이터 파이프라인 연동\n* 통합 광고 성과 리포트 생성\n\n
\"BizSpring

BizSpring AIR™

\n\n{% hint style=\"info\" %}\n웹사이트에서 BizSpring AIR™ 서비스의 전반적 기능을 확인할 수 있습니다.\n\n[BizSpring AIR™ 웹사이트 바로가기](https://growthplatform.ai/gmp/prd_air.php)\n{% endhint %}\n\n### API 사용 준비하기\n\nBizSpring AIR™ API를 처음 사용하는 경우 아래 순서로 진행합니다.\n\n{% content-ref url=\"../getting-started/api\" %}\n[api](../getting-started/api)\n{% endcontent-ref %}\n\n{% content-ref url=\"../getting-started/growth-platform-tm\" %}\n[growth-platform-tm](../getting-started/growth-platform-tm)\n{% endcontent-ref %}\n\n### 이미 API 사용 권한이 있는 경우\n\n이미 BizSpring AIR™ API 계정을 보유한 경우 아래 문서에서 **인증 토큰 발급**, **리포팅 API 요청**, **메타데이터와 코드값**을 확인합니다.\n\n{% content-ref url=\"../bizspring-air-tm-api-spec./auth-token\" %}\n[auth-token](../bizspring-air-tm-api-spec./auth-token)\n{% endcontent-ref %}\n\n{% content-ref url=\"../bizspring-air-tm-api-spec./air-tm-reporting-api\" %}\n[air-tm-reporting-api](../bizspring-air-tm-api-spec./air-tm-reporting-api)\n{% endcontent-ref %}\n\n{% content-ref url=\"../bizspring-air-tm-api-spec./metadata-code\" %}\n[metadata-code](../bizspring-air-tm-api-spec./metadata-code)\n{% endcontent-ref %}\n", "related_slugs": [], "faq": [], "jsonld": null, "keywords": [], "source_id": "gitbook:UJ9uzvHT9r6QImnjP8p4:Fz8LkKoKNNE2U0pK30rS", "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-23T14:32:38.444294+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": true, "total": 35, "issues": [ "숫자·규격 같은 검증 가능한 구체가 부족합니다", "핵심 요약 불릿이 3개 미만입니다", "Q&A 쌍이 3개 미만입니다" ], "applies": true }, "g3": { "pass": true, "required": false }, "stage": "1", "decided_at": "2026-08-23T14:32:37.773Z" }, "raw_id": "aaefe685-5ed0-4d58-89ba-d510035c87e1", "search_text": "BizSpring AIR™ API 소개 — BizSpring AIR™ API description: BizSpring AIR™ 광고 데이터 API와 리포팅 API 시작 가이드입니다. REST API 인증, JSON 요청 방식, 주요 사용 흐름을 안내합니다. BizSpring AIR™ API 소개 BizSpring AIR™ API 시작 가이드 BizSpring ---\ndescription: >-\n BizSpring AIR™ 광고 데이터 API와 리포팅 API 시작 가이드입니다. REST API 인증, JSON 요청 방식, 주요 사용\n 흐름을 안내합니다.\n---\n\n# BizSpring AIR™ API 소개\n\n## BizSpring AIR™ API 시작 가이드\n\n### BizSpring AIR™ 란?\n\n**BizSpring AIR™** (Ad Intelligence Report)는 비즈스프링이 제공하는 **광고 매체 통합 리포팅 솔루션**입니다.\n\n네이버, 카카오, 구글, 메타(Facebook/Instagram), 크리테오, 틱톡 등 국내외 주요 광고 플랫폼의 성과 데이터를 단 **1회 계정 연동**만으로 매일 자동으로 수집·통합하여, 하나의 통합 리포트로 제공합니다.\n\n> 💡 **한 줄 요약**: 여러 광고 매체를 일일이 접속하지 않아도, AIR™ 하나로 전체 광고 성과를 한눈에 파악할 수 있습니다.\n\n### AIR™ 의 핵심 가치\n\n#### ① 멀티 매체 통합\n\n광고주나 에이전시가 관리하는 **모든 광고 매체의 성과 데이터**를 통합합니다.\n\n* 키워드 검색광고: 네이버 SA, 카카오 키워드, 구글 Ads\n* 디스플레이/SNS: 메타, 카카오모먼트, 네이버 GFA, 크리테오, 틱톡, 데이블 등\n\n#### ② 자동 리포팅\n\n매일 아침, 전일자 광고 성과 데이터가 **자동으로 취합·가공**되어 제공됩니다.\n\n* 일·주·월 단위 정기 리포트 스케줄링\n* 이메일 / 슬랙 등 자동 발송\n\n#### ③ 데이터 결합 분석\n\n광고 매체 성과 데이터 + 비즈스프링 LOGGER™ 행동 데이터를 결합하여 더욱 정밀한 성과 분석이 가능합니다.\n\n#### ④ Growth Platform™ 연계\n\nAIR™ 는 비즈스프링 Growth Platform™ (오픈형 CDP)의 핵심 모듈로:\n\n* 고객 여정 전체 분석\n* 타겟 오디언스 세그먼트 생성\n* AI 기반 캠페인 최적화 와 연계할 수 있습니다.\n\n### AIR™ API 란?\n\nAIR™ API는 플랫폼에서 수집·가공된 **통합 광고 성과 데이터를 외부 시스템에서 직접 조회**할 수 있도록 제공되는 RESTful API입니다.\n\n| 기존 방식 | AIR™ API 활용 |\n| -------------------- | -------------------------- |\n| 각 매체별 API 토큰 발행 필요 | ✅ AIR™ 토큰 하나로 모든 매체 데이터 조회 |\n| 매체마다 다른 데이터 구조 파악 필요 | ✅ 통합된 공통 지표와 차원 체계 |\n| 개발자 인력 투입 및 유지보수 부담 | ✅ 비즈스프링이 매체 API 변경사항 관리 |\n| 매체별 데이터를 직접 가공·병합 | ✅ 가공·병합 완료된 데이터를 바로 수신 |\n\n### 주요 활용 사례\n\n* 맞춤형 광고 성과 대시보드 구축 (Looker Studio, Tableau, Power BI 등)\n* 사내 보고서 자동화 (Google Sheets, Slack 봇 등)\n* AI/ML 모델 입력 데이터 파이프라인\n* 내부 데이터(매출, 주문)와의 결합 분석\n\n### 지원 광고 매체\n\n| 구분 | 지원 매체 |\n| ---------- | --------------------------------------- |\n| 검색광고 (SA) | 네이버 검색광고, 카카오 키워드광고, 구글 Ads |\n| 디스플레이 (DA) | 네이버 GFA, 카카오모먼트, 메타, 크리테오, 틱톡, 데이블, 모비온 |\n\n### 비즈스프링 솔루션 생태계에서의 위치\n\n```\nGrowth Platform™ (오픈형 CDP)\n├── AIR™ ← 광고 매체 성과 통합 리포팅 (이 문서)\n├── LOGGER™ ← 웹/앱 사용자 행동 분석\n├── TAM™ ← 타겟 오디언스 세그먼트 추출\n├── CXM™ ← 마케팅 캠페인 자동화\n└── ADMonster™ ← 키워드 자동입찰 관리\n```\n\n\n\n### 기술 구성\n\nAPI는 [REST](https://ko.wikipedia.org/wiki/REST) 방식으로 동작합니다. 응답 데이터는 [JSON](https://ko.wikipedia.org/wiki/JSON) 형식으로 제공합니다.\n\n다음과 같은 용도에 적합합니다.\n\n* 광고 매체별 리포팅 데이터 자동 수집\n* 사내 대시보드 및 데이터 파이프라인 연동\n* 통합 광고 성과 리포트 생성\n\n
\"BizSpring

BizSpring AIR™

\n\n{% hint style=\"info\" %}\n웹사이트에서 BizSpring AIR™ 서비스의 전반적 기능을 확인할 수 있습니다.\n\n[BizSpring AIR™ 웹사이트 바로가기](https://growthplatform.ai/gmp/prd_air.php)\n{% endhint %}\n\n### API 사용 준비하기\n\nBizSpring AIR™ API를 처음 사용하는 경우 아래 순서로 진행합니다.\n\n{% content-ref url=\"../getting-started/api\" %}\n[api](../getting-started/api)\n{% endcontent-ref %}\n\n{% content-ref url=\"../getting-started/growth-platform-tm\" %}\n[growth-platform-tm](../getting-started/growth-platform-tm)\n{% endcontent-ref %}\n\n### 이미 API 사용 권한이 있는 경우\n\n이미 BizSpring AIR™ API 계정을 보유한 경우 아래 문서에서 **인증 토큰 발급**, **리포팅 API 요청**, **메타데이터와 코드값**을 확인합니다.\n\n{% content-ref url=\"../bizspring-air-tm-api-spec./auth-token\" %}\n[auth-token](../bizspring-air-tm-api-spec./auth-token)\n{% endcontent-ref %}\n\n{% content-ref url=\"../bizspring-air-tm-api-spec./air-tm-reporting-api\" %}\n[air-tm-reporting-api](../bizspring-air-tm-api-spec./air-tm-reporting-api)\n{% endcontent-ref %}\n\n{% content-ref url=\"../bizspring-air-tm-api-spec./metadata-code\" %}\n[metadata-code](../bizspring-air-tm-api-spec./metadata-code)\n{% endcontent-ref %}\n", "embedding": null, "embedded_at": null, "embedding_hash": null, "backlinks": [], "html_url": "https://bizspring.ai/kb/ref/manual/bizspring-air-api-bizspring-air-api-소개", "markdown_url": "https://bizspring.ai/kb/ref/manual/bizspring-air-api-bizspring-air-api-소개.md" }