페이스북 메타 광고 라이브러리 API 사용법

저희가 Facebook 광고 라이브러리 API라고 부르는 Facebook/Meta 광고 라이브러리 API는 개발자들이 Facebook, Instagram 및 기타 Meta 소유 플랫폼(예: Whatsapp, Threads)에 게시된 광고에 접근할 수 있도록 하는 공개 인터페이스입니다. 이 API를 통해 키워드, 페이지 ID, 국가 또는 광고 유형별로 광고를 검색하고 광고 소재, 지출 범위, 노출수, 게시자 플랫폼 등 다양한 메타데이터를 검색할 수 있습니다.

이 API는 투명성 연구, 마케팅 감사, 경쟁사 분석, 광고 소재 분석 또는 소셜 미디어 광고 데이터를 기반으로 한 도구 구축에 특히 유용합니다. 활성 광고를 모니터링하거나 정치/사회 문제 광고(SIEP 광고)를 연구하거나 마케팅 전략을 분석하려는 경우, Facebook 광고 라이브러리 API는 광고 데이터에 접근할 수 있는 강력한 문을 제공합니다.

💡

아름다운 API 문서를 생성하는 훌륭한 API 테스트 도구를 원하십니까?

개발팀이 최대 생산성으로 함께 작업할 수 있는 통합된 올인원 플랫폼을 원하십니까?

Apidog는 귀하의 모든 요구 사항을 충족하며, Postman을 훨씬 저렴한 가격으로 대체합니다!

버튼

Facebook 광고 라이브러리 API를 사용하는 이유 및 활용 범위

Facebook 광고 라이브러리 API의 주요 기능 중 일부는 다음과 같습니다:

키워드, 페이지 ID, 국가, 광고 유형으로 검색 — 광고 내용, 광고주, 실행 위치, 캠페인 종류에 따라 광고를 좁힐 수 있습니다.
상태별 필터링: 활성/비활성, 지출 범위, 노출수 — 현재 실행 중인 광고 또는 특정 지출 임계값 이상/이하의 광고만 보려는 경우 유용합니다.
광고 메타데이터 검색 — page_name, ad_snapshot_url, spend, impressions, publisher_platforms (Facebook/Instagram) 등의 필드를 포함합니다.
장기적이고 광범위한 데이터 범위 지원 — 예를 들어, SIEP 광고의 경우 전 세계적으로, 일반 광고의 경우 여러 지역에서 지원됩니다(2025년 기준 Meta의 지역 정책에 따름).
공개 데이터 무료 접근 — 적절한 접근 설정이 되어 있다면 공개 광고 데이터를 검색하는 데 선행 비용이 없습니다.

요컨대, 이 API는 대규모로 광고 데이터를 탐색하고 수집할 수 있는 구조화되고 프로그래밍 가능한 방법을 제공합니다.

단계별 가이드: Facebook 광고 라이브러리 API 시작하기

단계 1: Facebook/Meta 계정 및 신원 확인

Facebook 계정에 로그인하거나(개인 또는 비즈니스) 생성합니다.
계정이 확인되었는지 확인합니다 (Meta는 API 접근을 위해 신원 확인을 요구할 수 있습니다). (계정 확인)
이 단계는 앱을 통해 광고 라이브러리 데이터에 대한 접근을 요청할 계획이라면 특히 중요합니다.

단계 2: Meta 개발자 앱 등록

Meta for Developers를 방문하여 → “시작하기”를 클릭하고 플랫폼에 로그인합니다. (여기 클릭)

새 앱 생성: 광고하지 않는 경우 “기타” 또는 일반 유형을 선택합니다.

마케팅 API / 광고 라이브러리에 접근하기를 원한다고 선택합니다.

초기에는 앱이 개발 모드에 있습니다. 이는 기본적인 테스트 및 소규모 사용에 충분합니다.

단계 3: 접근 토큰 생성

Graph API Explorer 또는 Meta의 도구를 사용하여 사용자 접근 토큰을 생성합니다.
토큰에 필요한 권한(예: ads_read, Meta의 요구 사항에 따라 ads_archive 또는 기타)이 있는지 확인합니다. (Facebook for Developers)

참고: 접근 토큰은 만료됩니다. 사용량에 따라 토큰을 연장하거나 수명이 긴 토큰을 생성해야 할 수 있습니다.

단계 4: 첫 번째 API 호출

/ads_archive 엔드포인트(광고 라이브러리 API의 루트)를 쿼리할 수 있습니다. 최신 API 버전(예: v23.0 이상)을 사용하세요. (Facebook for Developers)

예시: curl 사용

curl -G \
  -d "search_terms=skincare" \
  -d "ad_reached_countries=['US']" \
  -d "ad_active_status=ACTIVE" \
  -d "fields=page_name,ad_snapshot_url,spend,impressions,publisher_platforms" \
  -d "access_token=YOUR_ACCESS_TOKEN" \
  "https://graph.facebook.com/v23.0/ads_archive"

예시: JavaScript (fetch) 사용

const response = await fetch(
  `https://graph.facebook.com/v23.0/ads_archive?` +
  `search_terms=skincare&ad_reached_countries=['US']&ad_active_status=ACTIVE` +
  `&fields=page_name,spend,impressions,publisher_platforms` +
  `&access_token=YOUR_ACCESS_TOKEN`
);
const data = await response.json();
console.log(data);

JSON 응답에는 page_name, ad_snapshot_url, 지출 범위, 노출수 범위, 게시자 플랫폼 등 메타데이터를 포함하는 광고 객체 배열이 포함되며, 잠재적으로 더 많은 필드가 있을 수 있습니다.

단계 5: 페이지네이션 및 대규모 결과 처리

광고 라이브러리가 많은 결과를 반환할 수 있으므로 API는 페이지네이션을 사용합니다. 후속 페이지를 반복할 준비를 하십시오. 응답에서 paging 또는 커서 토큰을 확인하고 그에 따라 반복합니다. 개발자들은 종종 코드에 루프를 구축하여 대규모 결과 세트를 집계합니다.

단계 6: 사용 사례 — 이 데이터로 무엇을 할 수 있나요?

다음은 일반적인 사용 사례입니다:

경쟁사 분석 — 경쟁사의 Facebook 페이지(페이지 ID를 통해)에서 광고를 검색하여 광고 소재, 예상 지출 또는 타겟팅 도달 범위를 연구합니다.
트렌드 모니터링 및 연구 — 키워드, 지역, 미디어 유형 또는 광고 유형(예: 정치, 주택, 사회 문제)별로 어떤 종류의 광고가 활성 상태인지 추적합니다.
마케팅 인텔리전스 대시보드 — 데이터(지출 범위, 노출수, 광고 빈도)를 집계하고 시간 또는 지역별로 시각화합니다.
광고 소재 분석 / 영감 — 제품 영감 또는 규정 준수 감사를 위해 광고 소재(이미지/비디오 URL)를 가져오고 보관합니다.
학술 / 투명성 연구 — 정치 광고, 사회 문제 캠페인 또는 시장 동향 연구를 위해 광고 데이터를 사용합니다.

이러한 사용 사례는 광고 데이터에 구조화되고 프로그래밍 가능한 접근 방식을 갖는 것의 가치를 강조합니다.

Apidog로 Facebook 광고 라이브러리 API 테스트하기

Apidog를 Facebook 광고 라이브러리 API의 테스트 환경으로 사용하세요. Apidog에서 API 테스트를 시작하는 방법은 다음과 같습니다:

1. Apidog에서 새 API 엔드포인트를 생성합니다: 메서드를 GET으로, URL을 https://graph.facebook.com/v23.0/ads_archive로 설정합니다.

2. 쿼리 파라미터 아래에 search_terms, ad_reached_countries, fields, access_token과 같은 파라미터를 추가합니다.

3. “전송”을 누르면 — Apidog가 데이터를 가져와 구조화된 형태로 JSON 응답을 보여줍니다.

4. 여러 파라미터 조합을 실험하고, 페이지네이션을 테스트하며, 문서화 또는 분석을 위해 예시 응답을 저장할 수도 있습니다.

이 접근 방식은 완전한 코드를 작성하지 않고도 빠른 광고 데이터 탐색, 검색 쿼리 테스트 및 통합 구축에 특히 유용합니다.

버튼

자주 묻는 질문

Q1. Facebook 광고 라이브러리 API를 사용하려면 특별한 광고 계정이나 비즈니스 계정이 필요한가요?
아니요. 일반적으로 인증된 Meta 계정만으로 충분합니다. 그러나 Meta 개발자 앱을 등록하고 적절한 권한(예: ads_read, ads_archive)을 가진 접근 토큰을 받아야 합니다. 일부 사용자는 모든 기능에 접근하기 위해 신원 확인을 완료해야 합니다.

Q2. 정치 또는 사회 문제 광고뿐만 아니라 모든 광고에 대한 데이터를 얻을 수 있나요?
예. API는 일반 광고(SIEP 광고뿐만 아니라)를 지원합니다. 지역 및 광고 가용성에 따라 ad_type=all을 사용하거나 필터를 생략할 수 있습니다.

Q3. 단일 요청으로 몇 개의 광고를 검색할 수 있나요?
기본적으로 API는 요청당 제한된 수의 광고를 반환합니다(페이지네이션). 더 많은 광고를 검색하려면 응답에 제공된 페이지 커서를 사용하여 페이지를 반복해야 합니다.

Q4. API를 통해 광고 소재(이미지, 동영상)에 접근할 수 있나요?
광고 소재 미리보기에 연결되는 ad_snapshot_url 또는 유사한 필드를 얻을 수 있습니다. 그러나 Meta는 항상 직접적인 미디어 파일을 제공하지는 않습니다. 실제 이미지 또는 동영상을 가져오려면 추가 단계가 필요할 수 있습니다.

Q5. 데이터 검색을 자동화하고 토큰 만료 문제를 피할 방법이 있나요?
예. Meta 개발자 도구에서 수명이 긴 토큰을 생성하거나 토큰을 주기적으로 새로 고치는 백엔드 시스템을 설정할 수 있습니다. 대규모 데이터 검색의 경우 토큰 관리와 페이지네이션 루프를 결합하는 것이 일반적입니다. 토큰은 항상 안전하게 보관하세요.

결론

Facebook (Meta) 광고 라이브러리 API는 광고 데이터에 대한 강력하고 구조화된 게이트웨이를 제공하여 개발자, 마케터, 연구원 및 분석가가 Meta 플랫폼 전반의 광고 캠페인을 프로그래밍 방식으로 검색, 수집 및 분석할 수 있도록 합니다. 이를 사용하여 대시보드를 구축하고, 경쟁사 분석을 실행하고, 투명성 연구를 수행하거나, 대규모로 광고 소재를 집계할 수 있습니다.

Meta 개발자 앱을 설정하고, 적절한 접근 토큰을 얻고, /ads_archive 엔드포인트에 요청을 함으로써(선택적으로 Apidog와 같은 도구를 통해 테스트) 풍부한 광고 라이브러리 데이터를 활용할 수 있습니다. 제한 사항(권한, 속도 제한, 페이지네이션, 미디어 검색)이 있지만, 그 이점은 종종 노력보다 큽니다.

Facebook/Meta에서 공개 광고 데이터가 필요한 모든 사람에게 광고 라이브러리 API는 가치 있고 공식적이며 유연한 옵션입니다.

💡

버튼