facebook-ad-library/
company-ads

광고주 페이지 ID 하나에 대한 공개 Facebook 광고 라이브러리 광고를 수집하여 크리에이티브 텍스트, 미디어, 페이지 정보, 게재 세부 정보, 공개된 지표를 정규화된 레코드로 반환합니다.

Facebook Ad Library Company Ads API

광고주 페이지 ID 입력
크리에이티브·게재 정보
공개 광고 레코드
결과당 0.5 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Facebook Ad Library Company Ads

Facebook 광고 라이브러리의 회사 광고는 크리에이티브 텍스트, 미디어, 페이지 정보, 게재 날짜, 활성 상태, 게시 플랫폼, 국가 정보, 공개된 지표를 담은 공개 광고주 레코드입니다. 이러한 레코드는 광고주 모니터링, 크리에이티브 비교, 시장별 검토, 수집 시점 기준 리포트에 활용할 수 있습니다.

Facebook Ad Library Company Ads API 주요 기능

  • 광고주 페이지 단위 수집키워드 검색이 아니라 숫자형 광고주 페이지 ID 하나를 사용해, 반환되는 모든 광고를 선택한 공개 페이지와 연결해 둡니다.
  • 시장·게재 필터레코드를 저장하기 전에 국가, 게재 상태, 미디어 유형, 언어, 기간, 지원되는 정렬 순서로 수집 범위를 좁힐 수 있습니다.
  • 크리에이티브·미디어·도착 페이지 필드광고마다 확인 가능한 제목, 본문 텍스트, 이미지 또는 동영상, CTA 값, 공개 도착 URL, 표시 형식을 반환합니다.
  • 광고주·게재 정보공개적으로 노출되는 경우 페이지 정보, 페이지 좋아요 수, 게재 날짜, 활성 상태, 게시 플랫폼, 국가, 도달, 통화, 지출을 유지합니다.
  • 범위가 정해진 고유 광고 레코드확인 가능한 원본 페이지를 따라가며 중복된 아카이브 ID나 URL을 제거하고, results_limit 또는 마지막 페이지에서 멈춥니다.

Facebook Ad Library Company Ads API 매개변수

매개변수필수설명
page_id필수숫자형 Facebook 광고 라이브러리 광고주 페이지 ID로, 필수 값입니다. 페이지 ID를 모른다면 먼저 Company Search를 사용하세요. 작업 하나에 페이지 ID 하나를 받습니다.
results_limit선택저장할 고유 광고의 최대 개수입니다. 기본값은 100이며 20~2,000 범위의 정수를 받습니다.
country선택ALL 또는 두 글자 국가 코드 하나를 사용하세요. 기본값은 ALL입니다.
status선택광고 게재 상태 필터입니다. ALL, ACTIVE, INACTIVE 중 정확히 하나를 사용하며, 기본값은 ACTIVE입니다.
media_type선택크리에이티브 미디어 필터입니다. ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE 중 정확히 하나를 사용하며, 기본값은 ALL입니다.
language선택두 글자 광고 언어 코드이며 선택 항목입니다.
sort_by선택반환되는 광고를 total_impressions 또는 relevancy_monthly_grouped 기준으로 정렬합니다. 기본값은 total_impressions입니다.
start_date선택YYYY-MM-DD 형식의 시작 날짜이며 선택 항목입니다. end_date보다 늦을 수 없습니다.
end_date선택YYYY-MM-DD 형식의 종료 날짜이며 선택 항목입니다. start_date보다 빠를 수 없습니다.

Facebook Ad Library Company Ads API 사용 방법

광고주 페이지 ID 하나와 선택 필터를 제출하고, 비동기 작업을 추적한 뒤, 정규화된 광고 레코드를 커서 페이지네이션으로 읽습니다.

  1. 숫자형 광고주 페이지 ID를 확인하고, 필요한 국가, 상태, 미디어, 언어, 정렬, 기간 필터를 선택합니다.
  2. page_id와 선택한 필터를 /v1/facebook-ad-library/company-ads에 제출하고, task_id를 확보합니다.
  3. 처리가 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, has_more가 true인 동안 next_cursor로 다음 페이지를 요청합니다.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/company-ads" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page_id":"51212153078","results_limit":100,"country":"US","status":"ACTIVE","media_type":"ALL"}'

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

Facebook Ad Library Company Ads API 추천 활용 사례

  • 광고주 광고 모니터링: 알고 있는 광고주 페이지의 아카이브 ID, 크리에이티브 텍스트, 미디어, 활성 상태, 게재 날짜, 원본 URL, collected_at을 추적합니다.
  • 크리에이티브·포맷 비교: 해당 페이지에서 반환된 광고들의 텍스트, 이미지·동영상, 표시 형식, CTA, 도착 링크, collation 맥락을 비교합니다.
  • 시장별 필터 광고 검토: 국가, 언어, 상태, 미디어, 기간 필터를 적용해 특정 시장이나 게재 관련 질문별로 광고 세트를 따로 구성합니다.
  • 공개 지표 스냅샷 리포트: 공개적으로 노출되는 경우 페이지 정보, 페이지 좋아요 수, 도달, 지출, 통화, 게재 상태, collected_at을 함께 정리합니다.

Facebook Ad Library Company Ads API 활용 팁

  • country를 ALL로 두고 미디어·기간 필터를 넓게 잡은 뒤 조건을 하나씩 좁혀 가세요. 그래야 결과가 비었을 때 원인을 정확히 해석할 수 있습니다.
  • 페이지 ID와 필터 조합을 검증하는 동안에는 최솟값인 results_limit 20을 사용하고, 반환 범위가 작업 목적에 맞을 때만 늘리세요.
  • Company Ads 요청 하나는 페이지 ID 하나만 받으므로, 광고주 페이지 ID가 여러 개인 브랜드는 작업을 따로 제출하세요.
  • 반복 실행한 결과는 광고 id로 중복을 제거하고, 누락된 도달, 지출, 미디어, 날짜는 0이 아니라 확인할 수 없는 값으로 취급하며, 성과를 주장하는 용도가 아니라 그룹화 용도로 collation 필드를 사용하세요.

Facebook Ad Library Company Ads API 외에 Facebook Ad Library의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Facebook Ad Library Search API — 키워드로 공개 광고를 검색하며, 일치 방식, 광고, 국가, 상태, 미디어, 정렬, 날짜, 결과 수 제한을 지정할 수 있습니다.
  • Facebook Ad Library Company Search API — 회사 또는 페이지 이름으로 광고주 페이지 후보를 찾고, 페이지 ID, 분류, 이미지, 공개된 오디언스, 연결된 Instagram 신호를 반환합니다.
  • Facebook Ad Library Ad API — URL로 광고 라이브러리의 공개 광고 하나를 수집하며, 크리에이티브, 광고주, 미디어, 게재, CTA, 공개된 신호 필드를 포함합니다.

다른 플랫폼 둘러보기

Facebook Ad Library 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Facebook Ad Library Company Ads API — 자주 묻는 질문

Facebook Ad Library Company Ads API는 숫자형 광고주 페이지 ID 하나에 대한 공개 광고를 가져옵니다. 정규화된 크리에이티브, 미디어, 광고주, 게재, 시장, CTA, 공개 지표, 수집 시각 필드를 반환합니다.

회사 또는 브랜드 이름으로 Facebook 광고 라이브러리 Company Search를 사용한 뒤, 반환된 후보 중 올바른 숫자형 페이지 ID를 골라 Company Ads에 제출하세요.

국가, 게재 상태, 미디어 유형, 두 글자 언어 코드, 시작·종료 날짜로 필터링할 수 있고, 지원되는 두 가지 정렬 순서 중 하나를 선택할 수 있습니다. results_limit은 저장되는 고유 광고의 최대 개수를 제어합니다.

선택한 페이지에 국가, 상태, 미디어, 언어, 기간 필터와 일치하는 공개 광고가 없거나, 더 가져올 원본 페이지가 없을 수 있습니다. 성공했지만 결과가 비어 있는 경우 임의의 광고를 만들지 않습니다.

반환된 광고 레코드 1건당 0.5 SocQ 크레딧이 차감됩니다. 결과가 비어 있으면 결과 요금이 없습니다.