facebook-ad-library/
ad

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

Facebook Ad Library Ad API

광고 라이브러리 URL
크리에이티브·광고주 정보
공개된 게재 지표
결과당 0.6 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Facebook Ad Library Ad

Facebook 광고 라이브러리의 광고는 크리에이티브 텍스트, 광고주 정보, 미디어, 클릭 유도 문구(CTA), 게재 시점, 활성 상태, 확인 가능한 도달·지출 지표를 담은 공개 광고 레코드입니다. 이러한 필드는 선택한 광고의 정보 보강, 크리에이티브 검토, 공개 게재 모니터링, 특정 시점 비교에 활용할 수 있습니다.

Facebook Ad Library Ad API 주요 기능

  • 광고 라이브러리 URL 직접 확인숫자형 id 쿼리 매개변수가 있는 공개 /ads/library URL 하나를 정규화된 광고 레코드 최대 1건으로 변환합니다.
  • 크리에이티브·광고주 정보광고 아카이브 ID, 크리에이티브 제목과 텍스트, 광고주 페이지 정보, 공개 페이지 URL, CTA, 노출되는 경우 도착 링크를 반환합니다.
  • 게재 정보와 공개 지표공개 레코드에서 제공하는 경우 시작·종료 시각, 활성 상태, 게시 플랫폼, 국가 정보, 페이지 좋아요 수, 도달, 통화, 지출을 보존합니다.
  • 정규화된 다중 카드 미디어표준 필드에는 확인 가능한 스냅샷 또는 첫 번째 카드의 텍스트를 선택하고, 스냅샷과 카드 전반의 이미지·동영상 자산은 중복을 제거해 담되 변형별 전체 표는 제공하지 않습니다.

Facebook Ad Library Ad API 매개변수

매개변수필수설명
url필수공개 Facebook 광고 라이브러리 광고 URL로, 필수 값입니다. 정식 형식인 https://www.facebook.com/ads/library/?id={numeric_id}를 사용하세요. 요청 한 번에 URL 하나를 받습니다.

Facebook Ad Library Ad API 사용 방법

공개 광고 라이브러리 URL 하나를 제출하고, 비동기 작업을 추적한 뒤, 표준 결과 구조에서 정규화된 광고 레코드를 읽습니다.

  1. 경로가 /ads/library이고 쿼리에 숫자형 id가 포함된 공개 Facebook 광고 라이브러리 URL을 하나 준비합니다.
  2. url을 /v1/facebook-ad-library/ad에 제출하고, 반환된 task_id를 확보합니다.
  3. 작업이 성공하거나 실패를 반환할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽습니다. 이 엔드포인트는 레코드를 최대 1건 반환하므로 next_cursor는 보통 null, has_more는 false로 유지됩니다.
curl -X POST "https://api.socq.ai/v1/facebook-ad-library/ad" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.facebook.com/ads/library/?id=702369045530963"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this operation returns at most one item

Facebook Ad Library Ad API 추천 활용 사례

  • 선택한 광고 정보 보강: 아카이브 ID, 광고주 정보, 크리에이티브 제목, 본문 텍스트, 미디어, CTA, 도착 URL, 입력 URL로 기존 광고 레코드를 보완합니다.
  • 크리에이티브 자산·도착 페이지 검토: 알고 있는 광고의 중복 제거된 이미지·동영상 참조를 표시 형식, CTA 텍스트, CTA 유형, 공개 도착 링크와 함께 살펴봅니다.
  • 공개 게재 맥락 검토: 활성 상태, 시작·종료 시각, 게시 플랫폼, 국가 값, 확인 가능한 도달·지출 필드로 공개 게재 맥락을 살펴봅니다.
  • 특정 시점 광고 스냅샷 보존: 같은 광고를 나중에 비교할 수 있도록 크리에이티브, 광고주, 게재, 공개 지표, 입력 URL, collected_at 필드를 저장합니다.

Facebook Ad Library Ad API 활용 팁

  • 경로가 정확히 /ads/library이고 숫자형 id 쿼리 매개변수가 있는 광고 라이브러리 URL을 제출하세요. 페이지 URL, 페이지 ID, 게시물 URL, 광고 ID 단독 값은 입력으로 받지 않습니다.
  • 제출한 URL의 형식이 올바른데 레코드 없이 성공한 작업은 광고를 사용할 수 없거나 찾을 수 없는 정상적인 결과로 취급하세요.
  • 도달, 지출, 페이지 좋아요 수, 미디어, end_at, 광고주 프로필 URL, CTA, 국가 값은 선택적인 공개 필드로 다루고, 누락된 값을 0으로 바꾸지 마세요.
  • 카드나 크리에이티브가 여러 개인 광고는 정규화된 name과 text를 대표 필드로 사용하고, 중복 제거된 미디어 목록이 변형별 전체 표라고 가정하지 말고 살펴보세요.

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

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

다른 플랫폼 둘러보기

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

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

Facebook Ad Library Ad API는 제출한 광고 라이브러리 URL에서 공개 광고 하나를 가져옵니다. 정규화된 크리에이티브 텍스트, 광고주 정보, 미디어, 게재 시점, CTA, 확인 가능한 공개 지표를 반환합니다.

정식 형식인 https://www.facebook.com/ads/library/?id={numeric_id}의 공개 URL을 하나 제출합니다. 경로는 /ads/library여야 하고 id 쿼리 매개변수는 숫자여야 합니다.

레코드에는 광고 아카이브 ID와 URL, 크리에이티브 제목과 텍스트, 광고주 페이지 필드, 미디어, 게재 날짜와 상태, 게시 플랫폼, 국가 값, CTA 정보, 도착 URL, 페이지 좋아요 수, 도달, 통화, 지출, 수집 정보가 포함될 수 있습니다.

형식이 올바른 URL이 사용할 수 없거나 찾을 수 없는 공개 광고를 가리킬 수 있습니다. 이 경우 임의의 결과를 만들지 않고 작업만 성공으로 끝날 수 있습니다.

정규화된 name과 text는 확인 가능한 스냅샷 또는 첫 번째 카드의 값을 선택하고, media에는 스냅샷과 카드 전반에서 찾은 고유 자산이 담깁니다. 이 레코드는 모든 크리에이티브 변형을 담은 전체 표가 아닙니다.

정상적으로 반환된 광고 레코드 1건당 0.6 SocQ 크레딧이 차감됩니다. 결과를 반환하지 않은 작업에는 결과 요금이 없습니다.