google-ad-library/
advertiser-search

검색어와 선택 지역으로 공개 Google Ads Transparency Center 광고주 후보를 찾아, 정규화된 식별 정보, 웹사이트, 로고, 지역, 확인 가능한 광고 수 필드를 반환합니다.

Google Ad Library Advertiser Search API

광고주 후보
선택 지역 정보
안정적인 식별 필드
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Google Ad Library Advertiser Search

Google Ads Transparency Center에서는 브랜드, 조직, 웹사이트 검색어 하나에 대해 지역별 법인이나 이름이 비슷한 주체를 포함한 여러 광고주 레코드가 나타날 수 있습니다. 각 레코드의 ID, 이름, 웹사이트, 로고, 지역, 확인 가능한 광고 수를 살펴보면 광고 소재를 수집하기 전에 알맞은 공개 광고주 레코드를 고르는 데 도움이 됩니다.

Google Ad Library Advertiser Search API 주요 기능

  • 이름 기반 광고주 탐색비어 있지 않은 브랜드, 조직, 광고주 또는 웹사이트 검색어 하나로 검색하면 광고 소재가 아니라 정규화된 광고주 후보를 받습니다.
  • 선택 지역 정보US 같은 지역을 전달해 상위 검색에 지역 맥락을 더할 수 있으며, 이 지역은 광고 게재 지역과는 별개로 다룹니다.
  • 후보 식별 필드공개 광고주 ID, 이름, URL, 웹사이트, 로고, 지역, 원본에서 제공하는 광고 수를 추정 정보 없이 그대로 비교합니다.
  • 단일 응답 전체 저장한 번의 상위 검색 응답에서 반환된 사용 가능한 광고주를 모두 저장하며, 호출자가 지정하는 결과 개수 제한이나 제공처 페이지네이션 반복은 적용되지 않습니다.

Google Ad Library Advertiser Search API 매개변수

매개변수필수설명
query필수비어 있지 않아야 하는 광고주, 브랜드, 조직 또는 웹사이트 검색어로, 필수 값입니다. 일치 방식은 원본에 따라 다르며 완전 일치, 접두사 일치, 유사 일치 중 무엇이 적용될지 보장되지 않습니다.
region선택US처럼 비어 있지 않은 지역 문자열로, 선택 값입니다. 지리적 검색 맥락으로 전달되며, 광고주의 광고가 해당 지역에 게재되었음을 증명하지는 않습니다.

Google Ad Library Advertiser Search API 사용 방법

검색어를 제출하고 비동기 작업을 따라간 뒤, 정규화된 광고주 후보를 하나씩 검토한 다음 이후 조사에 해당 식별 정보를 사용합니다.

  1. 구체적인 광고주, 브랜드, 조직 또는 웹사이트 검색어를 정하고, 필요하면 US 같은 지역을 추가합니다.
  2. query와 선택 항목인 region을 /v1/google-ad-library/advertiser-search로 POST하고, task_id를 저장합니다.
  3. 작업이 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽고, 광고주 ID를 선택하기 전에 이름의 유사성만이 아니라 여러 정보를 함께 보고 후보의 신원을 확인합니다.
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Nike","region":"US"}'

# Poll GET /v1/tasks/{task_id}
# Review data.results.items as advertiser candidates

Google Ad Library Advertiser Search API 추천 활용 사례

  • 브랜드를 광고주 ID로 확인: 이름이나 웹사이트 검색어로 후보 목록을 만든 뒤, 별도의 공개 광고 목록 요청에 사용할 광고주 ID를 고릅니다.
  • 지역·법인별 주체 구분: 비슷한 레코드 여러 개가 자회사, 리셀러, 무관한 조직 중 무엇인지 알기 어려울 때 이름, 지역, 웹사이트, 공개 광고주 페이지를 비교합니다.
  • 검토 대기열 생성: 이름이 비슷하다는 이유만으로 소유 관계를 단정하지 않고, 후보 식별 정보와 수집 시각을 저장해 수동으로 확인합니다.

Google Ad Library Advertiser Search API 활용 팁

  • 정확한 법인명, 브랜드 또는 도메인에 가까운 검색어를 사용하세요. 너무 넓은 표현은 모호한 후보를 만들 수 있고 일치 규칙도 보장되지 않습니다.
  • region은 검색 맥락일 뿐이며, 해당 광고주의 모든 광고가 그 지역에서 게재되었다는 근거가 아닙니다.
  • 레코드를 병합하거나 광고 소재를 수집하기 전에 ID, 이름, 웹사이트, 지역, 공개 광고주 페이지로 후보를 확인하세요.
  • results_limit은 보내지 마세요. 이 작업은 한 번의 상위 응답에서 반환된 사용 가능한 광고주 배열을 저장하며 원본을 페이지네이션하지 않습니다.

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

  • Google Ad Library Ad API — URL로 알고 있는 공개 Transparency Center 크리에이티브 하나를 가져오며, 광고주, 문구, 미디어, 게재, 지역, 형식, 랜딩, 노출 필드를 포함합니다.
  • Google Ad Library Company Ads API — 회사 도메인 또는 광고주 ID로 공개 Transparency Center 크리에이티브를 수집하며, 주제, 지역, 날짜, 게재면, 형식, 결과 수 제한을 지정할 수 있습니다.

다른 플랫폼 둘러보기

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

Google Ad Library Advertiser Search API — 자주 묻는 질문

Google Ad Library Advertiser Search API는 검색어와 선택 지역으로 공개 Google Ads Transparency Center 광고주 후보를 찾는 프로그래밍 인터페이스입니다. 광고 소재가 아니라 정규화된 광고주 식별 정보와 원본에 따라 제공되는 웹사이트, 로고, 지역, 광고 수 필드를 반환합니다.

광고주 후보만 반환합니다. 공개 광고 소재를 나열하려면 확인된 광고주 ID나 도메인을 별도의 회사 광고 작업에 사용하세요.

지역은 광고주 검색에 전달되는 지리적 맥락입니다. 후보를 좁히는 데 도움이 될 수 있지만, 정확히 걸러 주는 필터도 아니고 광고 게재 지역을 나타내는 근거도 아닙니다.

아니요. 수집 시점의 한 번의 상위 검색 응답에서 반환된 사용 가능한 광고주 배열 전체이며, SocQ의 페이지네이션 반복이나 호출자가 지정하는 개수 제한은 없습니다.

저장된 광고주 레코드 1건당 0.5 SocQ 크레딧이 차감됩니다. 예상 요금은 결과 100건을 기준으로 하며 초과분도 허용하고, 성공했지만 결과가 비어 있으면 설정된 기본 요금 0 크레딧만 청구됩니다.