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 사용 방법
회사명 또는 페이지 이름을 하나 제출하고, 비동기 작업을 추적한 뒤, 정규화된 광고주 페이지 후보를 검토합니다.
- 비어 있지 않은 회사명, 브랜드명 또는 공개 페이지 이름을 하나 준비합니다.
- query를 /v1/facebook-ad-library/company-search로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
- 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 trueFacebook 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 계정, 팔로워 수, 인증 값, 이미지, 삭제된 페이지 여부는 선택적 신호로 취급하고, 필드가 없다고 해서 후보를 제외하지 말고 그대로 처리하세요.
관련 API
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, 공개된 신호 필드를 포함합니다.