{
  "slug": "ref/manual/bizspring-air-api-bizspring-air-api-소개",
  "doc_type": "ref",
  "title": "BizSpring AIR™ API 소개 — BizSpring AIR™ API",
  "title_en": null,
  "one_liner": "BizSpring AIR™ 광고 데이터 API와 리포팅 API 시작 가이드입니다. REST API 인증, JSON 요청 방식, 주요 사용 흐름을 안내합니다. BizSpring AIR™ API 소개 BizSpring AIR™ API 시작 가이드 BizSpring",
  "summary_bullets": [
    "BizSpring AIR™는 네이버, 카카오, 구글, 메타, 크리테오, 틱톡 등 광고 매체 성과를 1회 연동으로 자동 통합하는 리포팅 솔루션입니다.",
    "AIR™ API는 통합된 광고 성과 데이터를 외부 시스템에서 조회할 수 있는 RESTful API로, JSON 형식으로 응답을 제공합니다.",
    "AIR™ 토큰 하나로 여러 매체 데이터를 조회할 수 있어 매체별 토큰 발급과 데이터 가공 부담을 줄여줍니다.",
    "AIR™는 대시보드 구축, 사내 보고서 자동화, AI/ML 파이프라인 등 다양한 활용 사례에 쓰일 수 있습니다.",
    "AIR™는 Growth Platform™(오픈형 CDP) 내에서 LOGGER™, TAM™, CXM™, ADMonster™와 함께 광고 성과 통합 리포팅 역할을 담당합니다."
  ],
  "body_md": "# 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\nAPI는 [REST](https://ko.wikipedia.org/wiki/REST) 방식으로 동작합니다. 응답 데이터는 [JSON](https://ko.wikipedia.org/wiki/JSON) 형식으로 제공합니다.\n\n다음과 같은 용도에 적합합니다.\n\n* 광고 매체별 리포팅 데이터 자동 수집\n* 사내 대시보드 및 데이터 파이프라인 연동\n* 통합 광고 성과 리포트 생성\n\n> 웹사이트에서 BizSpring AIR™ 서비스의 전반적 기능을 확인할 수 있습니다.\n>\n> [BizSpring AIR™ 웹사이트 바로가기](https://growthplatform.ai/gmp/prd_air.php)\n\n### API 사용 준비하기\n\nBizSpring AIR™ API를 처음 사용하는 경우 아래 순서로 진행합니다.\n\napi\n\ngrowth-platform-tm\n\n### 이미 API 사용 권한이 있는 경우\n\n이미 BizSpring AIR™ API 계정을 보유한 경우 아래 문서에서 **인증 토큰 발급**, **리포팅 API 요청**, **메타데이터와 코드값**을 확인합니다.\n\nauth-token\n\nair-tm-reporting-api\n\nmetadata-code",
  "related_slugs": [],
  "keywords": [],
  "faq": [
    {
      "a": "비즈스프링이 제공하는 광고 매체 통합 리포팅 솔루션으로, 여러 광고 플랫폼의 성과 데이터를 1회 계정 연동만으로 매일 자동 수집·통합해 하나의 리포트로 제공합니다.",
      "q": "BizSpring AIR™가 정확히 뭔가요?"
    },
    {
      "a": "기존에는 매체별로 API 토큰을 발급받고 데이터 구조를 각각 파악해야 했지만, AIR™ API는 토큰 하나로 모든 매체 데이터를 조회할 수 있고 통합된 공통 지표 체계로 가공·병합된 데이터를 바로 받을 수 있습니다.",
      "q": "AIR™ API를 쓰면 기존 방식과 뭐가 다른가요?"
    },
    {
      "a": "검색광고로는 네이버 검색광고, 카카오 키워드광고, 구글 Ads를 지원하며, 디스플레이광고로는 네이버 GFA, 카카오모먼트, 메타, 크리테오, 틱톡, 데이블, 모비온을 지원합니다.",
      "q": "어떤 광고 매체를 지원하나요?"
    },
    {
      "a": "AIR™ API는 REST 방식으로 동작하며 응답 데이터는 JSON 형식으로 제공됩니다.",
      "q": "API 응답은 어떤 형식으로 받나요?"
    },
    {
      "a": "문서에서 안내하는 API 시작 가이드와 Growth Platform™ 관련 문서를 먼저 확인하고, 이미 계정이 있다면 인증 토큰 발급, 리포팅 API 요청, 메타데이터와 코드값 문서를 참고하면 됩니다.",
      "q": "AIR™ API를 처음 사용하려면 어떻게 시작하나요?"
    }
  ],
  "jsonld": null,
  "image_url": null,
  "caption": null,
  "width": null,
  "height": null,
  "video_url": null,
  "duration_sec": null,
  "thumbnail_url": null,
  "solution_slug": null,
  "source_id": "gitbook:UJ9uzvHT9r6QImnjP8p4:Fz8LkKoKNNE2U0pK30rS",
  "created_at": "2026-08-23T14:32:38.444294+00:00",
  "updated_at": "2026-09-03T04:45:05.349+00:00",
  "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"
}