지식센터 / 레퍼런스

광고주 수 / Advertiser Count — AIR MCP

광고주 수 / Advertiser Count

매체별로 최근 30일간 실제 집행한 활성 광고주 수를 반환한다. 개별 광고주는 식별되지 않고 distinct 카운트만 집계된다.

get_advertiser_count_by_media

30일 cardinality

애드온 · 시장 집계 데이터

광고주 개별 계정에서 나오는 AIR 매체 데이터가 아니라

AIR 매체 통합 데이터

daas.gmp.ai

1. 파라미터

파라미터

값

설명

verbosity

compact

full

full

2. 호출

https://mcp.gmp.ai/air

curl -X POST https://mcp.gmp.ai/air \

-H "Authorization: Bearer YOUR_CLIENT_API_KEY" \

-H "Content-Type: application/json" \

-d '{

"tool": "get_advertiser_count_by_media",

"verbosity": "full"

}'

3. 응답 schema

{

"data": {

"period": { "start": "YYYY-MM-DD", "end": "YYYY-MM-DD", "days": 30 },

"media": [

{

"code": "naver_sa",

"name": "NAVER SA",

"distinct_clients": <integer>,

"rank": <integer>,

"program_count": <integer> // verbosity: "full" 에서만

}

]

},

"_citation": {

"suggested_citation_ko": "비즈스프링 AIR (2026). 매체별 활성 광고주 수. https://air.gmp.ai",

"license": "CC-BY 4.0",

"data_authority": "Bizspring"

},

"_methodology": {

"aggregation": "client 단위 집계 (CR-09 격리)",

"cardinality_method": "30일 구간 distinct client 카운트",

"anonymization": "개별 광고주 식별 정보 미포함"

},

"_metadata": {

"tool": "get_advertiser_count_by_media",

"version": "v0.7"

}

}

4. 응답 필드

필드

타입

설명

code

string

매체 코드

name

string

매체 표시명

distinct_clients

integer

30일 내 집행한 광고주 수 (중복 제거)

rank

integer

광고주 수 기준 순위

program_count

integer

full

5. 인용

CC-BY 4.0 — 출처 표기 시 자유롭게 인용·재사용할 수 있다.

비즈스프링 AIR (2026). 매체별 활성 광고주 수. https://air.gmp.ai

Bizspring AIR (2026). Active Advertiser Count by Media. https://air.gmp.ai

6. 다음 단계

전체 API 문서

daas.gmp.ai 에서 더 보기 →

매체 점유율

시즌 추이

API key 발급 문의

출처: https://air.gmp.ai/advertisers

자주 묻는 질문

이 도구로 개별 광고주를 식별할 수 있나요?

아니요, 개별 광고주는 식별되지 않고 매체별 distinct 카운트만 집계되어 제공됩니다. 응답에도 개별 광고주 식별 정보는 포함되지 않습니다.

집계 기간은 어떻게 되나요?

최근 30일간 실제 집행한 활성 광고주 수를 기준으로 집계합니다. 응답의 period 필드에서 구체적인 시작일과 종료일을 확인할 수 있습니다.

verbosity 파라미터는 무엇이 다른가요?

compact와 full 두 가지 값이 있으며, full로 설정하면 program_count 필드가 추가로 응답에 포함됩니다.

이 데이터는 어디서 나온 데이터인가요?

광고주 개별 계정에서 나오는 AIR 매체 데이터가 아니라, AIR 매체 통합 데이터를 기반으로 한 시장 집계 데이터입니다.

이 데이터를 외부에 인용해도 되나요?

네, CC-BY 4.0 라이선스로 제공되어 출처를 표기하면 자유롭게 인용·재사용할 수 있습니다. 제안된 인용 표기 문구는 응답의 _citation 필드에 포함되어 있습니다.

관련 문서

이 문서를 참조하는 문서 (역링크)

• AIR — 광고 캠페인 주요 매체를 하나의 API/MCP로. Claude·ChatGPT가 직접 조회하고, 리포트·자동화가 같은 소스를 씁니다.

다른 표현: Markdown · JSON · 최종 갱신 2026-09-06