API 목록으로 돌아가기
독립형 공개 광고 투명성 데이터

Google Ad Library API

공개 광고주를 찾고, 기업별 크리에이티브를 수집하고, 이미 알고 있는 Transparency Center 크리에이티브 하나를 URL로 가져와 리서치와 검토에 활용합니다.

사용할 수 있는 Google Ad Library API

후보 탐색에는 Advertiser Search, 범위가 정해진 크리에이티브 수집에는 Company Ads, 정확한 공개 크리에이티브 URL 하나의 상세 조회에는 Ad Details를 사용합니다.

어떤 Google 광고 투명성 데이터를 가져올 수 있나요?

SocQ는 Transparency Center에서 공개된 필드를 정규화하며, 제공되지 않는 원본 값은 null이나 빈 값으로 그대로 둡니다.

광고주 탐색

검색어로 후보 광고주의 식별 정보, 웹사이트, 로고, 지역, 제공되는 광고 수 필드를 찾습니다.

크리에이티브와 이동 경로 정보

제공되는 텍스트, 광고주 참조, 형식, 미디어 자산, 랜딩 페이지 도착 주소를 수집합니다.

공개 게재 정보

제공되는 날짜, 국가, Google 게재 영역, 안전하게 정규화된 노출 값을 보존합니다.

SocQ와 Google Ads 제품

SocQ는 지원하는 공개 투명성 레코드를 정규화합니다. 권한이 부여된 계정과 캠페인을 운영할 때는 Google Ads 제품이 알맞은 선택입니다.

기능SocQGoogle Ads 제품
주요 용도공개 투명성 레코드 탐색과 정규화권한이 부여된 광고 계정과 캠페인 관리
입력검색어, 기업 식별자와 필터, 또는 정확한 크리에이티브 URL제품별 계정, 캠페인, 리포트 입력
인증SocQ API 키제품별 Google 자격 증명과 권한 부여
응답 형식정규화된 공개 광고주·광고 레코드제품별 고유 응답

Google Ad Library API 작동 방식

세 엔드포인트 모두 SocQ의 비동기 제출, 폴링, 결과 읽기 흐름을 따릅니다.

  1. 1. 엔드포인트 선택

    Advertiser Search에는 검색어, Company Ads에는 도메인이나 광고주 ID, Ad Details에는 크리에이티브 URL 하나를 제출합니다.

  2. 2. 작업 제출과 추적

    요청을 POST하고 task_id를 저장한 뒤, 처리가 끝날 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 정규화된 결과 읽기

    data.results.items를 처리합니다. Company Ads는 요청한 상한을 지키고, Ad Details는 최대 1건을 반환합니다.

기업 하나의 공개 광고 수집

SocQ API 키로 인증하고 기업 도메인이나 광고주 ID 중 하나를 지정합니다. 결과 상한 기본값은 40입니다.

curl -X POST "https://api.socq.ai/v1/google-ad-library/company-ads" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"lululemon.com","results_limit":40}'

# Also available:
# POST /v1/google-ad-library/advertiser-search
# POST /v1/google-ad-library/ad
# Poll GET /v1/tasks/{task_id}

Google Ad Library API 주요 활용 사례

광고주 탐색

광고를 수집하기 전에 브랜드나 웹사이트 검색어를 공개 광고주 후보로 확정합니다.

기업 크리에이티브 리서치

주제, 지역, 날짜, 게재 영역, 형식 필터를 선택적으로 적용해 범위가 정해진 공개 크리에이티브 세트를 수집합니다.

선택한 크리에이티브 정보 보강

이미 알고 있는 크리에이티브 레코드에 광고주, 텍스트, 미디어, 도착 주소, 게재 필드를 채워 넣습니다.

제한 사항과 공개 데이터 정책

결과는 현재 공개된 원본에서 보이는 내용에 따라 달라지며, 비공개 Google Ads 계정 데이터는 제공하지 않습니다.

  • Advertiser Search는 검색어 하나가 필요하고 지역은 선택 사항이며, results_limit 입력은 없습니다.
  • Company Ads는 domain 또는 advertiser_id가 필요하고, results_limit은 40부터 2,000까지 40의 배수로 지정할 수 있습니다.
  • Ad Details는 경로에 /creative/가 포함된 adstransparency.google.com URL 하나가 필요하며 최대 1건을 반환합니다.
  • 공개 레코드는 불완전할 수 있으며, 비공개 예산, 클릭, 전환, 입찰가, 타겟 오디언스, 광고 수익률은 제공하지 않습니다.

Google Ad Library API 자주 묻는 질문

어떤 엔드포인트부터 사용해야 하나요?

브랜드나 웹사이트만 알면 Advertiser Search, 도메인이나 광고주 ID가 있으면 Company Ads, 정확한 크리에이티브 URL이 있으면 Ad Details를 사용합니다.

기업 광고를 필터링할 수 있나요?

네. 주제, 지역, 기간, Google 게재 영역, 형식, 상한이 있는 results_limit을 선택적으로 지정할 수 있습니다.

비공개 캠페인 성과에 접근할 수 있나요?

아니요. 공개 투명성 레코드만 다루며, 비공개 계정이나 캠페인 분석 데이터는 제공하지 않습니다.

결과 요금은 어떻게 되나요?

반환된 레코드 1건당 0.5 SocQ 크레딧이며, 빈 결과에는 별도로 설정된 기본 요금이 없습니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.

Google Maps API

공개 장소를 찾고, 이미 알고 있는 Maps URL의 정규화된 상세 정보를 가져오고, 출처가 연결된 장소·작성자 정보와 함께 공개 리뷰를 수집합니다.

Amazon API

지원되는 마켓플레이스에서 공개 Amazon 상품을 검색하고, 정규화된 상품 상세 정보, Best Sellers, 리뷰, 판매자 프로필, 크리에이터 스토어 레코드를 수집합니다.

Apple App Store API

이미 알고 있는 스토어 URL에서 공개 Apple App Store 앱 상세 정보, 카테고리 순위, 리뷰를 정규화된 앱·리뷰 레코드로 수집합니다.

SEO API

실시간 Google 오가닉 검색 결과를 조회하고, 키워드 수요와 순위 난이도를 비교하고, 시드 키워드를 확장하고, 사이트의 검색 노출을 이끄는 키워드와 페이지를 찾고, 검색 의도를 분류하며, Google 뉴스·이미지·자동완성과 Bing, YouTube 결과를 모읍니다. 모든 엔드포인트가 같은 SocQ API 키, 비동기 작업 흐름, 정규화된 결과 형식을 사용합니다.

Telegram API

t.me 링크로 공개 텔레그램 채널을 읽습니다. 구독자 수가 담긴 채널 정보, 조회수와 반응이 담긴 게시물, 개별 게시물, 토론 그룹 댓글, 추천 채널, 전체 기록 검색을 지원합니다.

Link in Bio API

크리에이터가 Instagram, TikTok, YouTube 소개란에 넣는 링크 하나를 표시 이름, 소개, 프로필 사진, 공개된 연락처 이메일, 연결된 SNS 프로필, 각 버튼의 제목과 연결 주소라는 구조화된 데이터로 바꿉니다.