facebook-ad-library/
company-search

회사명 또는 페이지 이름으로 Facebook Ad Library의 공개 광고주 페이지를 검색하고, 페이지 ID, 카테고리, 이미지, Instagram 오디언스 신호를 정규화된 레코드로 반환합니다.

Facebook Ad Library Company Search API

회사명·페이지 이름 검색
광고주 페이지 후보
페이지·Instagram 신호
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Facebook Ad Library Company Search

Facebook 광고 라이브러리의 회사 후보는 페이지 ID, 이름, 카테고리, 국가, 이미지, 인증 값, 연결된 Instagram 정보로 식별되는 광고주 페이지입니다. 이러한 식별 정보와 오디언스 신호는 광고 조사에 앞서 광고주 확정, 동일한 이름의 페이지 비교, 검토 가능한 페이지 선택에 활용할 수 있습니다.

Facebook Ad Library Company Search API 주요 기능

  • 회사명·페이지 이름 검색비어 있지 않은 회사명, 브랜드명 또는 페이지 이름을 하나 제출하면 해당 조회에서 반환된 광고주 페이지 후보를 모두 받을 수 있습니다.
  • 페이지 식별 정보와 분류페이지 ID, 이름, 파생된 공개 URL, 카테고리, 국가, 엔터티 유형, 인증 값, 이미지, 그리고 공개되는 경우 삭제된 페이지 여부를 반환합니다.
  • 공개된 페이지·Instagram 신호확인 가능한 Facebook 좋아요 수를 연결된 Instagram 사용자 이름, 팔로워 수, 인증 상태와 함께 정규화된 후보 레코드에 담아 보존합니다.

Facebook Ad Library Company Search API 매개변수

매개변수필수설명
query필수광고주 페이지 후보를 찾는 데 사용하는 회사명, 브랜드명 또는 공개 페이지 이름으로, 비어 있지 않아야 하는 필수 값입니다.

Facebook Ad Library Company Search API 사용 방법

회사명 또는 페이지 이름을 하나 제출하고, 비동기 작업을 추적한 뒤, 정규화된 광고주 페이지 후보를 검토합니다.

  1. 비어 있지 않은 회사명, 브랜드명 또는 공개 페이지 이름을 하나 준비합니다.
  2. query를 /v1/facebook-ad-library/company-search로 POST하고, 반환된 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-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Example Sports"}'

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

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

  • 광고주 페이지 ID 확정: 후보의 페이지 ID, 이름, URL, 카테고리, 국가를 보고 페이지 단위 Company Ads 요청에 필요한 식별자를 선택합니다.
  • 동일 이름·지역별 페이지 비교: 비슷한 광고주 이름 사이에서 카테고리, 국가, 엔터티 유형, 이미지, 인증 값, 연결된 Instagram 정보를 비교합니다.
  • 검토 가능한 광고주 선택기: 페이지 식별 정보, 공개된 오디언스 신호, 원래 검색어, 수집 시각을 광고주 선택기나 조사용 색인에 저장해 둡니다.

Facebook Ad Library Company Search API 활용 팁

  • query만 보내세요. Company Search는 results_limit 매개변수와 광고 상태, 국가, 미디어, 날짜 필터를 받지 않습니다.
  • 여러 후보가 비슷한 이름을 쓰고 있다면 첫 번째 결과를 고르지 말고 페이지 ID, URL, 카테고리, 국가, 이미지, 인증 여부, 연결된 Instagram 계정을 비교하세요.
  • 저장된 회사 후보가 작업 결과 페이지네이션에 가려지지 않도록 has_more가 false가 될 때까지 next_cursor를 따라가세요.
  • Instagram 계정, 팔로워 수, 인증 값, 이미지, 삭제된 페이지 여부는 선택적 신호로 취급하고, 필드가 없다고 해서 후보를 제외하지 말고 그대로 처리하세요.

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

  • Facebook Ad Library Search API — 키워드로 공개 광고를 검색하며, 일치 방식, 광고, 국가, 상태, 미디어, 정렬, 날짜, 결과 수 제한을 지정할 수 있습니다.
  • Facebook Ad Library Company Ads API — 광고주 페이지 ID 하나에 대한 공개 광고를 수집하며, 크리에이티브, 게재, 시장, 미디어, CTA, 공개된 신호 필드를 포함합니다.
  • Facebook Ad Library Ad API — URL로 광고 라이브러리의 공개 광고 하나를 수집하며, 크리에이티브, 광고주, 미디어, 게재, CTA, 공개된 신호 필드를 포함합니다.

다른 플랫폼 둘러보기

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

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

Facebook Ad Library Company Search API는 비어 있지 않은 회사명 또는 페이지 이름으로 공개 광고주 페이지 후보를 찾아 주는 API입니다. 페이지 ID, 식별·분류 필드, 이미지, 공개된 오디언스 지표, 연결된 Instagram 정보를 반환합니다.

이 엔드포인트는 비어 있지 않은 필수 query 문자열 하나만 받습니다. results_limit 매개변수와 광고 국가, 상태, 미디어, 언어, 정렬, 날짜 필터는 지원하지 않습니다.

아니요. 광고주 페이지 후보와 Company Ads에서 사용하는 숫자형 페이지 ID를 반환하며, 광고 소재나 게재 레코드는 반환하지 않습니다.

페이지 ID, 이름, URL, 카테고리, 국가, 엔터티 유형, 이미지, 인증 값, 연결된 Instagram 계정을 비교하세요. 이름이 익숙하다는 것만으로는 그 후보가 찾던 광고주라고 확신할 수 없습니다.

회사 조회는 results_limit 매개변수를 받지 않으며, 검색어에 대해 반환된 고유한 공개 페이지 ID를 모두 저장합니다. 완료된 작업의 저장된 레코드는 next_cursor와 has_more로 페이지네이션할 수 있습니다.

items 배열이 비어 있다면 해당 검색어로 조회된 공개 페이지 후보가 없다는 뜻입니다. 이름 표기의 차이나 공개 출처의 제공 여부 때문에 비어 있을 수 있으므로, 그 회사에 광고가 없다는 증거는 아닙니다.

반환된 회사 후보 1건마다 0.5 SocQ 크레딧이 차감됩니다. 요청 견적은 후보 10건을 기준으로 하며, 현재 과금 설정에서는 결과가 비어 있으면 결과 요금이 발생하지 않습니다.