메타 광고 라이브러리 API 가이드: 화면 검색부터 조회 범위 이해하기

경쟁사 광고를 메타 광고 라이브러리 화면에서 찾아 기록하는 순서와 API의 조회 범위를 설명합니다. 게재 정보만으로 광고 성과를 판단할 수 없는 이유와 요청과 응답을 읽는 방법도 정리했습니다.

홍승협(준이아빠)게시 2026.09.15수정 2026.10.04약 21분

지금까지 50명 넘게 읽었어요, 66%가 끝까지 읽었어요

#Meta 광고 #광고 #API #마케팅 실무

메타 광고 라이브러리 API 가이드: 화면 검색부터 조회 범위 이해하기 대표 이미지

준이아빠AI가 일하는 법AI 친구들의 작업실 구경하기 ↗

세 가지 도구가 보여 주는 범위
화면에서 한 광고주의 광고 찾아 기록하기
화면에서 알 수 있는 것과 없는 것
어떤 광고를 API로 받을 수 있나요?
API가 필요할 때의 준비
응답을 읽는 법
같은 조사를 다시 할 때
3줄 요약

세 줄로 먼저 읽기

메타 광고 라이브러리 화면에서는 광고의 소재와 문구, 게재 시작일을 볼 수 있지만 일반 상업 광고의 클릭수와 구매수, 광고 수익은 공개되지 않습니다.
광고 라이브러리 API는 전 세계 정치와 사회 이슈 광고 최근 7년과 영국이나 EU에 게재된 모든 광고 최근 1년을 조회하므로 한국에만 게재된 일반 상업 광고는 받을 수 없습니다.
게재 기간이 길거나 소재 버전이 많다는 사실은 성과의 증거가 아니어서 보고서에는 관찰과 미확인 값, 가설을 나눠 적습니다.

경쟁사가 어떤 광고를 내보내는지 알고 싶다면 Meta 광고 라이브러리 화면에서 시작합니다. 광고 라이브러리는 Meta가 자사 서비스에 게재된 광고를 누구나 검색할 수 있게 공개한 페이지입니다. 다만 화면에 보이는 광고 가운데 API로 받을 수 있는 것은 일부입니다.

API는 프로그램이 다른 서비스의 자료를 요청하는 기능입니다. 광고 라이브러리 API를 쓰기 전에, 조사하려는 광고가 조회 대상에 들어가는지부터 봅니다. 이 글은 화면에서 광고를 찾아 기록하는 순서를 먼저 설명하고, API가 필요한 경우 요청과 응답을 읽는 법으로 이어 갑니다.

세 가지 도구가 보여 주는 범위

메타 광고 자료를 보는 도구는 세 가지이고, 볼 수 있는 광고와 숫자가 서로 다릅니다.

도구별로 볼 수 있는 광고와 숫자

보려는 것	라이브러리 화면누구나 검색	라이브러리 API프로그램으로 조회	마케팅 API Insights권한 있는 광고 계정
다른 회사의 공개 광고 소재	제공	지원 범위 안만	제공하지 않음
한국에만 게재된 일반 상업 광고	제공	제공하지 않음	제공하지 않음
프로그램으로 자동 조회	제공하지 않음	제공	제공
광고 비용과 전환	정치, 사회 이슈 광고의 지출만 범위로	정치, 사회 이슈 광고의 지출만 범위로	우리 계정만

경쟁사 소재 몇 개를 비교하는 일은 화면으로, 우리 계정의 비용과 전환 보고는 Insights로 합니다.

Insights는 광고 성과를 조회하는 기능입니다. 우리 계정의 실적이 목적이라면 Meta 광고 API 안내를 봅니다. 다른 회사의 공개 광고를 조회할 수 있어도, 그 회사의 실제 비용이나 매출, 고객 명단은 어느 도구로도 볼 수 없습니다.

화면에서 한 광고주의 광고 찾아 기록하기

일반 상품이나 서비스의 광고를 조사한다면 아래 순서로 찾습니다.

광고 라이브러리에서 광고주의 광고를 찾는 순서

1. 국가조사할 국가를
대한민국으로
2. 광고 분류일반 상품이면
모든 광고
3. 브랜드 검색결과에서 실제 조사 대상의
페이지인지 확인
4. 필터필요하면 활동 상태
플랫폼, 미디어 유형
5. 상세 정보 기록라이브러리 ID, 게재 시작일
소재 특징

페이지는 광고주가 Facebook에서 쓰는 공개 계정이고, 라이브러리 ID는 광고마다 붙는 고유 번호입니다. 3번에서는 이름이 비슷한 판매점이나 대행사의 광고가 함께 나올 수 있어, 페이지 이름과 연결 정보를 대조해 실제 광고주를 고릅니다.

검색 결과 카드에는 활성 상태, 라이브러리 ID, 게재 시작일, 소재가 함께 보입니다. 화면 캡처에는 국가와 검색 조건이 잘려 나가기 쉬우므로, 조건은 기록표에 따로 적습니다. 기록표는 아래 칸이면 충분합니다.

칸	적을 내용
확인 날짜	화면을 본 날
국가와 광고주	선택한 국가, 대조해 고른 페이지 이름
라이브러리 ID	화면에 나온 ID를 그대로
시작일	표시된 게재 시작일, 없으면 미표시
관찰한 특징	영상인지 이미지인지, 무엇을 보여 주는지
모르는 것	비용, 구매수, 실제 노출 비중

화면에 "여러 버전"이나 "같은 소재 사용" 표시가 있으면 그 문구도 남깁니다. 다만 표시된 숫자는 서로 다른 이미지의 개수나 제작비가 아니므로 그렇게 바꿔 적지 않습니다. 광고가 몇 개 없으면 보이는 만큼만 적습니다.

결과가 없을 때

국가, 광고 분류, 광고주, 활동 상태 필터를 다시 봅니다. 조건은 한 번에 하나씩 바꿔야 어떤 조건이 결과를 바꿨는지 알 수 있습니다. 광고주가 브랜드 이름과 다른 이름으로 페이지를 등록했을 수도 있습니다.

결과가 없다는 것은 "이 조건으로는 찾지 못했다"는 뜻일 뿐, 그 회사가 광고를 하지 않는다는 증거는 아닙니다. 광고 라이브러리 도움말에 따르면 연령 제한이 걸린 소재는 로그인 여부와 연령 조건에 따라 보이지 않을 수 있습니다.

화면에서 알 수 있는 것과 없는 것

한국의 일반 상업 광고에서 화면으로 볼 수 있는 것은 소재, 문구, 페이지, 게재 정보입니다. 정치나 사회 이슈 광고는 여기에 지출과 노출이 더해지는데, 정확한 값이 아니라 범위로 표시됩니다.

광고 종류별로 화면에 나오는 정보

정보	일반 상업 광고한국에 게재	정치, 사회 이슈 광고별도 공개 대상
소재와 문구, 페이지	제공	제공
게재 시작일	제공	제공
지출과 노출	제공하지 않음	범위로 표시
클릭수, 구매수, 광고 수익	제공하지 않음	제공하지 않음

어느 광고든 클릭수와 구매수, 광고 수익은 공개되지 않습니다.

위 화면의 일부 광고 카드에는 지출 범위와 노출 범위가 보입니다. 범위의 중간값은 실제 비용이 아니고, 노출은 구매수와 다른 지표입니다. 노출은 광고가 표시된 횟수이고, 도달은 광고를 본 계정 수여서 둘도 서로 다릅니다.

오래 게재됐다는 사실만으로는 잘 팔린다는 결론이 나오지 않습니다. 적은 예산으로 오래 유지했거나 중간에 집행을 바꿨을 수도 있습니다. 소재 버전이 여러 개라는 사실도 어느 버전이 더 많이 노출됐는지, 어느 버전이 구매를 만들었는지는 알려 주지 않습니다.

그래서 보고서에는 관찰과 가설을 나눠 적습니다.

관찰: 조사일에 이 광고가 활성 상태였고 시작일은 9월 20일로 표시됐다.
미확인: 실제 누적 지출, 중간 중지 여부, 구매수와 매출.
가설: 사용 장면 중심 설명을 우리 상품에서도 시험해 볼 수 있다.
검증: 우리 계정에서 비교 조건을 정하고 직접 성과를 측정한다.

어떤 광고를 API로 받을 수 있나요?

Meta의 API 안내가 밝힌 조회 범위는 두 가지입니다. 전 세계의 정치와 사회 이슈 광고는 최근 7년, 영국이나 EU(유럽 연합)에 게재된 모든 유형의 광고는 최근 1년입니다. 화면의 보관 기간도 같은 기준을 따릅니다. 정치와 사회 이슈 광고는 7년, 영국과 EU 등 관련 지역에 게재된 광고는 마지막 노출 후 1년 동안 보관됩니다.

광고 종류와 게재 지역별 API 조회와 화면 보관

광고	API로 조회ads_archive	화면 보관광고 라이브러리
정치와 사회 이슈 광고	최근 7년	7년
영국, EU에 게재된 광고	최근 1년	마지막 노출 후 1년
한국 회사가 독일에 낸 광고	해당할 수 있음	해당할 수 있음
한국에만 게재된 일반 상업 광고	제공하지 않음	보관 대상 아님

기준은 광고주의 국적이 아니라 광고 종류와 광고가 게재된 국가입니다.

한국에만 게재된 일반 상업 광고는 이 범위에 들어가지 않습니다. 같은 기준으로, 한국 회사라도 독일에 광고를 냈다면 조회 대상이 될 수 있고, 미국 회사라도 한국에만 낸 일반 상품 광고라면 대상이 아닙니다. 보관 대상이 아닌 일반 상업 광고는 게재가 끝나면 화면에서 사라질 수 있으니, 필요한 소재는 볼 수 있을 때 기록해 둡니다.

API가 필요할 때의 준비

API 시작 절차는 아래 순서로 안내돼 있습니다. 앱은 API를 쓰는 주체를 등록하는 단위이고, 액세스 토큰은 API 이용 권한을 확인하는 비밀 인증값입니다. 토큰은 비밀번호처럼 다루고 어디에도 공개하지 않습니다.

광고 라이브러리 API를 쓰기까지

1. 신원과 위치 확인Facebook 계정에서
신원과 위치 인증
2. 개발자 계정Meta 개발자 계정
준비
3. 앱 추가API를 쓸 앱을
등록
4. 토큰 발급과 조회액세스 토큰으로
ads_archive 요청

승인에 걸리는 시간은 상황마다 다릅니다. 인증과 접근 설정이 끝나야 조회할 수 있습니다.

아래는 독일에 게재된 광고를 찾는 요청을 설계한 예입니다. 바로 실행하는 명령이 아니므로, 실제 토큰을 넣어 브라우저 주소창에 붙여 넣지 않습니다.

요청 방식: GET
조회 경로: /<사용할 API 버전>/ads_archive
ad_reached_countries: ["DE"]
ad_type: ALL
ad_active_status: ALL
search_terms: fitness
fields: id,page_name,ad_creative_bodies,ad_delivery_start_time

GET은 자료를 조회하는 요청이고 ads_archive는 공개 광고를 검색하는 경로입니다. 국가 코드 DE는 독일, KR은 대한민국입니다. fields에는 응답에서 받을 항목을 적습니다. 실제 호출은 인증을 마친 개발 환경에서 공식 문서가 지원하는 버전에 맞춰 만듭니다.

검색 조건과 기본값 문서에 따르면 검색어는 자동으로 번역되지 않으므로, 찾으려는 광고의 언어로 적어야 합니다. 활동 상태를 빼면 게재 중인 광고만 뜻하는 ACTIVE가 기본값으로 들어갑니다. 끝난 광고까지 함께 보려면 전체 상태를 뜻하는 ALL을 적습니다. 광고주의 페이지 ID로 찾을 때는 search_page_ids를 씁니다.

응답을 읽는 법

위 요청을 보내면 응답은 아래와 같은 형태로 옵니다.

ads_archive 응답

GET /ads_archive?ad_reached_countries=["DE"]&search_terms=fitness

{"data": [{
"id": "1234567890",
"page_name": "Example Brand",
"ad_creative_bodies": ["Try our fitness class"],
"ad_delivery_start_time": "2026-09-20T00:00:00+0000"
}]}

비용 필드가 없으면 비용은 미확인으로 둡니다

설명을 위해 만든 화면입니다. 실제 응답의 값과 항목 수는 요청 조건에 따라 달라집니다.

data는 받은 광고의 목록입니다. 이 화면에서는 광고가 한 개이고, ad_creative_bodies는 소재 문구를 담은 목록입니다. 한 광고에 문구가 여러 개일 수 있으므로 문구 개수를 광고 개수로 보지 않습니다. 응답에 비용 항목이 없다는 것은 그 값을 받지 못했다는 뜻이고, 비용은 미확인으로 남깁니다.

광고 필드 참조에 따르면 ad_delivery_start_time은 광고주가 설정한 게재 시작 시각이며 UTC, 즉 세계 표준시 기준입니다. 한국 시간과 비교할 때는 시간대를 맞춥니다. 이 값은 설정한 시작 시각이라, 실제 첫 노출 시각이나 중단 없이 집행됐다는 근거로 쓰지 않습니다.

결과가 더 있으면 응답의 paging에 다음 결과를 받는 정보가 들어옵니다. 한 페이지의 행 수는 전체 광고 수가 아닙니다. 다음 페이지까지 받을 때는 ID로 중복을 걸러 내고, 조회 조건과 수집 시점을 함께 저장합니다. 다음 페이지 URL이나 소재 조회 URL에는 인증값이 들어 있을 수 있어 보고서나 공개 로그에 그대로 남기지 않습니다.

받을 수 있는 필드는 광고의 지역과 종류에 따라 다릅니다. spend와 impressions는 정치와 사회 이슈 광고에서 범위 값으로 나오고, eu_total_reach는 EU 안의 도달 추정값입니다. 영국 도달은 이 EU 필드와 다른 값입니다.

결과가 비었거나 오류가 날 때

결과 또는 오류	먼저 볼 것
빈 `data`	지원 광고 범위, 국가, 검색어와 활동 상태
`190`	액세스 토큰이 유효한지, 인증 상태
`100`	국가와 필드 같은 요청 조건의 형식
`613`	호출 제한과 재시도 간격
일부 값이 없음	그 광고 종류와 지역에서 제공되는 필드인지

빈 목록을 광고가 없다는 뜻으로 해석하지 않고, 오류 응답을 빈 목록으로 저장하지도 않습니다. 오류 번호와 메시지는 기록하되 인증값은 빼고 남깁니다.

같은 조사를 다시 할 때

경쟁사 광고를 주기적으로 볼 때는 처음 기록한 국가, 광고주, 필터를 그대로 다시 씁니다. 검색 저장 기능을 쓸 수 없다면 검색 주소와 조건을 기록표에 적어 둡니다.

지난 조사와 이번 조사를 맞대는 순서

1. 같은 조건국가, 광고주, 필터를
지난번과 똑같이
2. ID 대조지난 기록표의
라이브러리 ID와 비교
3. 세 가지로 구분계속 보이는 것, 새로 보이는 것
더 찾지 못한 것
4. 관찰과 가설 분리본 사실과
우리 상품에 적용할 아이디어

더 찾지 못한 광고를 곧바로 "실패한 소재"라고 적지 않습니다. 광고주가 다른 이유로 집행을 끝냈을 수도 있고, 보관 대상이 아닌 광고라 화면에서 사라졌을 수도 있습니다.

공개된 소재라도 다시 쓰려면 이용 조건을 따라야 합니다. 광고 라이브러리 도움말에 따르면 검색 결과를 내려받으려면 로그인하고 이용 조건에 동의해야 합니다. API 소재 필드 문서도 소재를 저장할 때의 분석 목적과 보관 조건을 정해 둡니다. 보고서에 소재를 넣을 때는 자료 출처와 확인 날짜를 함께 적고, 그 이용 조건 안에서 씁니다.

3줄 요약

메타 광고 라이브러리 화면에서는 광고의 소재와 문구, 게재 시작일을 볼 수 있지만 일반 상업 광고의 클릭수와 구매수, 광고 수익은 공개되지 않습니다.
광고 라이브러리 API는 전 세계 정치와 사회 이슈 광고 최근 7년과 영국이나 EU에 게재된 모든 광고 최근 1년을 조회하므로 한국에만 게재된 일반 상업 광고는 받을 수 없습니다.
게재 기간이 길거나 소재 버전이 많다는 사실은 성과의 증거가 아니어서 보고서에는 관찰과 미확인 값, 가설을 나눠 적습니다.

제대로 이해했는지 한 문제로 확인해 볼까요?

답을 고르면 바로 풀이가 나와요.

대한민국에만 게재된 일반 화장품 광고를 광고 라이브러리 API로 받으려 할 때 먼저 알아야 할 점은 무엇인가요?

이 글이 도움이 되었나요?

이 글 다음 배우기디지털 마케팅 핵심 용어입문 코스 · 14편

광고 화면에 나오는 지표를 정의와 계산식으로 정리했습니다

코스 전체 보기 →

이어서 읽기 좋은 글메타 광고 소재 261개 조사: AI 추정 비중과 해석의 한계 →

2026년 9월의 광고 소재 조사에서 261개 중 28개가 AI 생성으로 추정됐습니다. 이 숫자를 국내 전체 사용률로 볼 수 없는 이유와 분모, 육안 분류, 게재 경과일을 해석하는 방법을 설명합니다.