광고주 확인 후 소재 수집
기업명으로 검색해 페이지를 찾고 해당 페이지의 광고를 요청합니다. 이 두 단계 흐름이 가장 많이 쓰이는 순서이며 소비자가 부르는 브랜드명만 알아도 동작합니다.
엔드포인트 순서
adlibrary/search/companies -> company/ads활용 사례
공개 광고 라이브러리를 조회하는 광고 인텔리전스 API
경쟁사가 비용을 들여 무엇을 말하는지 확인합니다. 페이스북 광고 라이브러리가 가장 깊은 레인입니다. 광고주를 찾은 뒤 국가와 상태, 형식, 기간으로 필터링해 집행 중인 소재와 종료된 소재를 가져옵니다. 도메인 기준 구글 광고도 같은 키로 조회합니다.
/v1/facebook/adlibrary
경쟁사가 집행 중인 소재
- GET /v1/facebook/adlibrary/search/companies
- GET /v1/facebook/adlibrary/company/ads
- GET /v1/linkedin/ads/search
- GET /v1/google/company/ads
광고 인텔리전스 API는 플랫폼이 의무적으로 공개하는 광고 투명성 라이브러리에서 특정 기업이 집행 중인 광고를 반환합니다. SocialCrawl은 페이스북 광고 라이브러리를 국가와 집행 상태, 미디어 형식, 기간 필터와 함께 깊이 있게 제공하고 도메인 기준 구글 광고를 같은 API 키와 공통 스키마로 제공합니다.
실제로 만들어지는 것
모두 현재 운영 중인 패턴입니다. 각 카드 아래의 엔드포인트 순서가 실제 호출 순서입니다.
소재 문구 자체를 검색
광고주가 아니라 광고 문구를 조회해 같은 주장이나 카테고리 용어에 입찰 중인 기업을 전부 찾습니다. 경쟁사로 인식하지 못했던 기업을 발견하는 방법입니다.
엔드포인트 순서
adlibrary/search/ads (by keyword)영상 광고를 텍스트로 확인
광고 한 건의 전체 레코드를 연 뒤 영상의 발화 내용을 요청합니다. 눈으로 훑어야 했던 소재 더미가 분류와 비교, 검색이 가능한 텍스트가 됩니다.
엔드포인트 순서
adlibrary/ad -> ad/transcript도메인 기준 검색 광고
경쟁사 도메인을 지정해 구글에서 집행 중인 광고를 가져옵니다. 소셜 레인과 묶으면 미디어 플랜의 한쪽이 아니라 양쪽을 확보합니다.
엔드포인트 순서
google/company/ads (by domain)링크드인은 보조 레인
링크드인 광고 검색도 같은 키로 호출합니다. 다만 운영 중인 업스트림 가운데 가장 불안정하므로 B2B 리포트의 근간이 아니라 추가 레인으로 다루어야 합니다.
엔드포인트 순서
linkedin/ads/search집행 시작과 종료 추적
같은 광고주 질의를 기간을 바꿔 다시 실행하고 변화를 기록합니다. 새로 등장하거나 사라지거나 집행 국가가 바뀐 소재가 신호이며 어제 자료를 보관해야 확인됩니다.
엔드포인트 순서
adlibrary/company/ads (date-ranged)광고 인텔리전스 API 동작 방식
네 번의 호출로 기업명에서 소재와 그 안의 문구까지 확인합니다. 넓게 조회한 뒤 필요한 광고만 엽니다.
조회는 크레딧으로 과금됩니다. 목록 엔드포인트에서 결과가 없으면 과금되지 않고 업스트림 실패는 자동 환불됩니다.
GET /v1/facebook/adlibrary/search/companies광고주 식별
기업명으로 검색해 실제 광고를 집행하는 페이지를 찾습니다. 광고 집행 페이지명이 브랜드명과 다른 경우가 많아 필요한 단계입니다.
호출당GET /v1/facebook/adlibrary/company/ads광고 목록 수집
국가와 집행 상태, 미디어 형식, 기간 필터를 적용해 해당 페이지의 광고를 요청합니다. 전체를 확보하려면 커서로 이어서 조회합니다.
페이지당GET /v1/facebook/adlibrary/ad광고 한 건 상세 조회
광고 한 건의 전체 레코드를 가져옵니다. 목록 응답에서는 확인할 수 없는 소재 상세가 포함됩니다.
호출당GET /v1/google/company/ads검색 광고 레인 추가
같은 경쟁사 도메인을 구글 광고에 조회해 리포트에 유료 검색과 유료 소셜을 함께 담습니다.
호출당
광고 데이터를 가져오는 소스
모두 같은 경쟁 리포트에서 동작하는 레인입니다. 링크를 열면 해당 플랫폼의 전체 엔드포인트를 확인합니다.
기존 구성과 비교
대부분 채널별 광고 분석 좌석을 구매하거나 광고 라이브러리를 직접 스크래핑합니다. 달라지는 지점은 다음과 같습니다.
| Capability | SocialCrawl | 일반적인 구성 |
|---|---|---|
| 접근 방식 | 일반 HTTP 호출로 광고 라이브러리 데이터를 조회하고 키 하나로 인증합니다. | 로그인 상태의 스크래퍼를 운영하며 페이지 구조가 바뀌면 중단됩니다. |
| 필터링 | 국가와 집행 상태, 미디어 형식, 기간을 질의 파라미터로 직접 지정합니다. | 전체를 내려받은 뒤 클라이언트에서 걸러 냅니다. |
| 소재 깊이 | 광고 상세와 영상 광고 자막을 제공하므로 소재가 검색 가능한 텍스트가 됩니다. | 썸네일과 링크만 제공하고 메시지는 사람이 직접 시청해 확인합니다. |
| 커버리지 | 유료 소셜과 유료 검색을 키 하나로 조회하며 46개 플랫폼의 오가닉 맥락을 함께 확인합니다. | 채널마다 구독을 따로 두고 로그인도 따로 관리합니다. |
| 과금 방식 | 소멸되지 않는 크레딧 팩으로 호출당 과금하며 업스트림 실패는 환불합니다. | 리포트 실행 여부와 무관하게 월 좌석 요금이 청구됩니다. |
| 제품화 가능 여부 | 가공된 고객용 화면으로 제공하는 것이 약관에 명시적으로 허용됩니다. | 대개 제한되거나 건별 협의가 필요합니다. |
광고 인텔리전스 API 자주 묻는 질문
광고 인텔리전스 API란 무엇입니까?
광고 인텔리전스 API는 기업이 현재 또는 과거에 집행한 광고를 스크린숏이 아니라 구조화된 레코드로 반환합니다. 출처는 플랫폼이 공개하는 광고 투명성 라이브러리이므로 실제로 노출된 광고에 대한 플랫폼 자체 기록입니다.
어떤 광고 라이브러리를 조회합니까?
페이스북 광고 라이브러리를 가장 깊게 제공하며 기업 검색과 기업별 광고, 문구 검색, 광고 상세, 영상 광고 자막을 포함합니다. 구글 광고주와 도메인 광고도 같은 키로 조회합니다. 링크드인 광고 검색은 제공되지만 업스트림이 가장 불안정합니다.
국가와 기간으로 필터링할 수 있습니까?
가능합니다. 국가와 집행 상태, 미디어 형식, 정렬, 시작일과 종료일이 페이스북 광고 엔드포인트의 질의 파라미터이며 실제 운영 트래픽이 사용하는 필터입니다. 결과는 커서 페이지네이션으로 반환되므로 광고주의 전체 이력을 순회할 수 있습니다.
페이스북 개발자 계정이 필요합니까?
필요하지 않습니다. SocialCrawl API 키 하나로 인증합니다. 광고 라이브러리를 조회하기 위해 등록할 앱과 심사 절차, 별도 자격 증명 갱신이 없습니다.
영상 광고의 실제 발화 내용을 확인할 수 있습니까?
가능합니다. 광고 상세가 단건 광고의 전체 레코드를 반환하고 광고 자막 엔드포인트가 라이브러리에 자막이 있는 영상 소재의 발화 내용을 반환합니다. 경쟁사의 소재 이력이 분류하고 기간별로 비교할 수 있는 텍스트가 됩니다.
광고비나 성과 지표도 포함됩니까?
포함되지 않습니다. 공개 광고 라이브러리는 소재와 광고주, 집행 기간을 공개할 뿐 예산과 성과는 공개하지 않습니다. 라이브러리 데이터로 경쟁사 광고비를 정확히 제시한다면 그것은 추정치입니다. 이 API가 제공하는 것은 실제로 집행된 내용이며 검증 가능한 부분입니다.
광고 모니터링 비용은 얼마입니까?
조회는 소멸되지 않는 크레딧 팩에서 차감됩니다. 좌석이나 채널이 아니라 호출 단위로 과금합니다. 주 단위 경쟁사 점검은 브랜드당 호출 몇 건으로 끝납니다. 가입 시 무료 크레딧 100개를 제공하며 카드 등록이 필요하지 않습니다.
AI에게 SocialCrawl을 물어보세요
요청
curl -G "https://socialcrawl.dev/v1/facebook/adlibrary/search/companies" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "query=Grow Therapy"curl -G "https://socialcrawl.dev/v1/facebook/adlibrary/company/ads" \
-H "x-api-key: $SOCIALCRAWL_API_KEY" \
--data-urlencode "pageId=123456789" \
--data-urlencode "country=GB" \
--data-urlencode "status=active"두 호출 모두 실제 데이터로 동작합니다. 키와 기업명만 바꾸면 그대로 실행됩니다.