API 목록으로 돌아가기
독립형 Facebook 광고 라이브러리 데이터

Facebook Ad Library API

키워드로 공개 Facebook 광고를 검색하고, 광고주 페이지를 찾고, 페이지 ID의 광고를 수집하거나, 알고 있는 광고 하나를 정규화된 광고 소재·미디어·게재·CTA·연결 URL 필드로 가져옵니다.

사용할 수 있는 Facebook Ad Library API

키워드 기반 광고 탐색에는 Search, 페이지 ID를 찾을 때는 Company Search, 해당 페이지의 광고를 수집할 때는 Company Ads, 알고 있는 공개 광고 하나를 가져올 때는 Ad Details를 사용합니다.

어떤 Facebook 광고 라이브러리 데이터를 가져올 수 있나요?

SocQ는 광고 소재 리서치, 경쟁사 모니터링, 캠페인 분석, 광고 데이터셋 구축에 쓸 수 있는 정규화된 공개 광고·광고주 레코드를 반환합니다.

광고 검색 결과

키워드 또는 정확한 문구로 공개 광고를 검색하며, 국가, 상태, 미디어, 광고 유형, 날짜, 정렬, 결과 제한 필터를 선택적으로 지정할 수 있습니다.

광고주 페이지 레코드

페이지 ID, 이름, URL, 카테고리, 국가, 이미지, 인증 값, 공개된 페이지 좋아요 수, 연결된 Instagram 정보를 찾습니다.

페이지별 광고 모음

숫자로 된 광고주 페이지 ID 하나에 대해, 선택 사항인 게재·미디어 필터와 함께 범위가 정해진 고유 공개 광고 세트를 수집합니다.

광고 소재 텍스트와 미디어

제공되는 광고 제목, 본문 텍스트, 링크 설명, 노출 형식과 중복이 제거된 공개 이미지·동영상 참조를 가져옵니다.

게재·시장 정보

제공되는 시작·종료 시각, 활성 상태, 게재 플랫폼, 국가, 도달, 통화, 지출, 페이지 좋아요 신호를 보관합니다.

CTA와 연결 URL

노출되는 경우 표시된 CTA 텍스트와 유형, 공개 연결 URL, 광고 라이브러리 URL, 광고주 신원 정보, 수집 타임스탬프를 가져옵니다.

SocQ vs Meta Ad Library API

SocQ는 바로 쓸 수 있는 공개 광고 수집 워크플로를 제공합니다. Meta의 Ad Library API는 Meta 광고 투명성 아카이브에 직접 접근하기 위한 공식 선택지입니다.

기능SocQMeta Ad Library API
주요 용도공개 광고 검색, 광고주 또는 광고 상세 정보 수집Meta 공식 광고 투명성 아카이브 조회
인증SocQ API 키, 고객의 Facebook OAuth 불필요Meta 앱, 액세스 토큰, Ad Library 접근 권한
시작 입력키워드, 회사 이름, 페이지 ID 또는 공개 Ad Library URL공식 아카이브 쿼리 매개변수와 Meta 식별자
광고 생성·관리지원하지 않음지원하지 않음, Meta Marketing API 사용
응답 형식정규화된 SocQ 레코드Meta Graph API 고유 객체

Facebook Ad Library API 작동 방식

API 4종 모두 같은 비동기 작업과 페이지네이션 결과 워크플로를 사용합니다.

  1. 1. API와 입력 선택

    필요한 레코드에 따라 키워드, 회사 이름, 숫자 페이지 ID 또는 공개 /ads/library URL로 시작합니다.

  2. 2. 작업 제출 및 추적

    알맞은 POST 요청을 보내고 반환된 task_id를 저장한 뒤, 처리가 끝날 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 정규화된 결과 읽기

    data.results.items를 처리하고, has_more가 true인 동안 next_cursor를 따라갑니다.

키워드로 공개 광고 검색

SocQ API 키로 인증하고 Search 엔드포인트에 키워드를 제출합니다. 다른 Ad Library API도 같은 작업 흐름을 따릅니다.

curl -X POST "https://api.socq.ai/v1/facebook-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","results_limit":100,"status":"ACTIVE"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Facebook Ad Library API 주요 활용 사례

경쟁사 광고 모니터링

선택한 광고주 페이지의 공개 광고를 추적하고, 광고 소재, 미디어, 게재 상태, 시장, CTA, 연결 URL을 시간에 따라 비교합니다.

광고 소재·메시지 리서치

제품, 카테고리, 브랜드 키워드를 검색해 공개 광고 문구, 형식, 미디어, CTA, 랜딩 페이지 연결 URL을 살펴봅니다.

광고주 탐색

회사 또는 브랜드 이름을 공개 페이지 ID와 신원 필드로 확인한 뒤, 특정 페이지의 광고 세트를 집중적으로 수집합니다.

광고 데이터셋 구축

분석에 쓸 수 있도록 정규화된 광고 ID, 광고주 레코드, 광고 소재 필드, 게재 정보, 출처 URL, collected_at 타임스탬프를 저장합니다.

제한 사항과 공개 데이터 정책

Facebook 광고 라이브러리 결과는 특정 시점의 공개 레코드입니다. 이 API들은 광고 계정을 관리하지 않으며 비공개 캠페인 성과 데이터도 제공하지 않습니다.

  • Search에는 비어 있지 않은 query 하나가 필요합니다. results_limit의 기본값은 100이고 20부터 2,000까지의 정수를 받습니다.
  • Company Search는 회사 또는 페이지 이름 쿼리 하나를 받고 results_limit은 받지 않으며, 이름이 비슷한 페이지 후보가 여러 개 반환될 수 있습니다.
  • Company Ads에는 숫자 페이지 ID 하나가 필요합니다. results_limit은 20부터 2,000까지 받으며, 필터에 따라 반환되는 레코드 수가 줄어들 수 있습니다.
  • Ad Details는 숫자 id가 있는 공개 facebook.com/ads/library URL 하나를 받고, 정규화된 광고 레코드를 최대 1건 반환합니다.
  • 광고, 페이지 또는 필터링된 결과 세트를 공개 원본에서 확인할 수 없으면, 완료된 작업이 레코드를 반환하지 않을 수 있습니다.
  • 도달, 지출, 통화, 미디어, 날짜, CTA, 연결 URL, 광고주 필드는 없을 수 있으며 0으로 해석해서는 안 됩니다.

Facebook Ad Library API 자주 묻는 질문

Facebook Ad Library API란 무엇인가요?

Facebook Ad Library API는 공개 광고 검색, 광고주 페이지 찾기, 페이지별 광고 수집, 알고 있는 공개 광고의 상세 정보 조회를 위한 SocQ 엔드포인트 모음입니다.

어떤 Facebook Ad Library API를 사용해야 하나요?

키워드 탐색에는 Search, 페이지 ID를 찾을 때는 Company Search, 해당 ID의 광고를 수집할 때는 Company Ads, 알고 있는 공개 Ad Library URL 하나에는 Ad Details를 사용하세요.

무엇을 검색하고 필터링할 수 있나요?

Search는 키워드 또는 정확한 문구와 함께 국가, 상태, 미디어, 광고 유형, 날짜, 정렬, 결과 제한 필터를 선택적으로 받습니다. Company Ads는 페이지별 게재·미디어 필터를 지원합니다.

어떤 공개 광고 데이터가 반환되나요?

결과에는 광고와 광고주의 신원 정보, 광고 소재 텍스트, 이미지 또는 동영상, 게재 날짜, 활성 상태, 게재 플랫폼, 국가, CTA, 연결 URL, 공개된 신호가 포함될 수 있습니다.

완료된 요청이 결과를 반환하지 않는 이유는 무엇인가요?

제출한 입력과 일치하는 항목이 공개 원본에 없거나, 필터가 모든 레코드를 제외했거나, 요청한 광고 또는 페이지가 더 이상 공개되어 있지 않을 수 있습니다.

Facebook 소셜 데이터 API나 Marketplace API와 같은 것인가요?

아니요. Facebook Ad Library 엔드포인트는 SocQ의 Facebook 페이지·게시물·댓글 API 및 Facebook Marketplace 판매 상품 API와 별개입니다.

Facebook Ad Library 결과의 요금은 어떻게 되나요?

Search 광고, Company Search 후보, Company Ads 레코드는 반환된 결과 1건당 0.5 크레딧입니다. Ad Details는 반환된 결과 1건당 0.6 크레딧이며, 빈 결과에는 결과 요금이 없습니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.