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 광고 투명성 아카이브에 직접 접근하기 위한 공식 선택지입니다.
| 기능 | SocQ | Meta 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. API와 입력 선택
필요한 레코드에 따라 키워드, 회사 이름, 숫자 페이지 ID 또는 공개 /ads/library URL로 시작합니다.
2. 작업 제출 및 추적
알맞은 POST 요청을 보내고 반환된 task_id를 저장한 뒤, 처리가 끝날 때까지 /v1/tasks/{task_id}를 폴링합니다.
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 trueFacebook 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 크레딧이며, 빈 결과에는 결과 요금이 없습니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
X API
공개 프로필, 팔로워·팔로잉 관계, 게시물, 답글, 인용, 리포스트한 사용자, 검색 결과, 현재 트렌드를 수집합니다. 일관된 결과를 리서치와 모니터링에 활용하세요.
LinkedIn API
알고 있는 URL에서 공개 LinkedIn 프로필, 기업, 게시물, 채용 공고 데이터를 가져옵니다. 식별 정보, 경력, 기업, 콘텐츠, 참여도, 채용 공고 필드가 정규화되어 제공됩니다.
Reddit API
알고 있는 URL에서 공개 Reddit 게시물과 댓글을 가져오고, 서브레딧의 새 글·인기 글·핫 게시물을 둘러보거나, 키워드와 게시 기간으로 토론을 검색합니다.
Pinterest API
공개 Pinterest 프로필 데이터를 가져오고, 알고 있는 핀을 확인하고, 선택한 프로필의 핀을 수집하거나 키워드로 검색해 크리에이터, 콘텐츠, 비주얼 트렌드를 리서치합니다.
Threads API
공개 Threads 프로필을 가져오고, 알고 있는 게시물을 확인하거나, 선택한 프로필의 게시물을 수집합니다. 식별 정보, 콘텐츠, 미디어, 참여도, 타임스탬프 필드가 정규화되어 제공됩니다.
Bluesky API
공개 Bluesky 프로필을 가져오고, 알고 있는 게시물 URL을 확인하거나, 계정 게시물 한 페이지를 수집해 정규화된 신원 정보, 콘텐츠, 미디어, 타임스탬프, 공개된 참여 필드로 받아 봅니다.



