API 목록으로 돌아가기
TikTok 광고 투명성

TikTok Ad Library API

검색어로 지원하는 공개 TikTok 광고 레코드를 찾거나, 알고 있는 광고 URL을 정규화된 필드로 확인해 리서치, 검토, 아카이빙에 활용합니다.

사용할 수 있는 TikTok Ad Library API

광고주나 키워드로 공개 광고 레코드를 찾을 때는 Search, 조건에 맞는 공개 광고 URL 하나를 확인할 때는 Ad Details를 사용합니다.

어떤 공개 광고 데이터를 가져올 수 있나요?

반환되는 필드는 각 지원 레코드에서 현재 공개된 정보를 반영하며, 제공되지 않는 원본 값은 null이나 빈 값으로 남습니다.

광고와 광고주 식별 정보

공개 광고 ID, 제공되는 레코드 URL, 광고주 이름, 광고주 참조, 안정적인 리소스 유형을 수집합니다.

크리에이티브와 도착 주소

제공되는 광고 문구, 형식, 미디어 참조, 공개 랜딩 페이지 URL을 확인합니다.

공개된 게재 정보

노출된 경우 지원하는 게재 날짜, 게시 시각, 국가, 플랫폼, 타겟 오디언스, 노출 수 정보를 읽습니다.

수집 정보

검토 대기열, 카탈로그, 리서치 데이터셋에 쓸 수 있도록 정규화된 출처·수집 필드를 보존합니다.

SocQ와 TikTok 광고 제품

SocQ는 지원하는 공개 투명성 레코드를 읽기 전용으로 수집합니다. TikTok의 자체 제품은 공개 라이브러리 접근부터 권한이 부여된 캠페인 관리까지 목적이 서로 다릅니다.

기능SocQTikTok 광고 제품
주요 용도지원하는 공개 광고 레코드 검색과 정규화제품에 따라 공개 투명성 조회 또는 권한이 부여된 캠페인 운영
입력광고주 또는 키워드 하나, 또는 알고 있는 광고 URL 하나해당 TikTok 서비스에 따라 다름
비공개 캠페인 데이터제공하지 않음해당 계정, 제품, 승인, 권한이 필요
작업읽기 전용 공개 데이터 워크플로Ads Manager에서 권한이 부여된 캠페인 운영 지원
응답 형식안정적인 SocQ 광고 레코드제품별 고유 화면 또는 응답

TikTok Ad Library API 작동 방식

두 엔드포인트 모두 비동기 제출, 폴링, 읽기 흐름을 따릅니다. Search는 원본 여러 페이지를 수집할 수 있고, Ad Details는 최대 1건을 반환합니다.

  1. 1. 엔드포인트 선택

    Search에는 광고주나 키워드 하나를, Ad Details에는 조건에 맞는 공개 TikTok 광고 URL 하나를 제출합니다.

  2. 2. 작업 폴링

    반환된 task_id로 처리가 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 정규화된 레코드 읽기

    data.results.items와 작업 결과 커서를 처리합니다. 상세 요청은 광고 0건 또는 1건을 반환합니다.

API 요청 한 번으로 시작

SocQ API 키로 인증합니다. Search의 기본 결과 수는 12건이며, Ad Details에는 페이지네이션과 results_limit이 없습니다.

curl -X POST "https://api.socq.ai/v1/tiktok-ad-library/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Anysphere","results_limit":12}'

# Or resolve one known ad URL:
# POST /v1/tiktok-ad-library/ad
# {"url":"https://library.tiktok.com/ads/detail/?id=1871655924410641"}
# Poll GET /v1/tasks/{task_id}

TikTok Ad Library API 주요 활용 사례

브랜드 모니터링

알고 있는 광고주 이름과 일치하는 공개 광고의 정기 검토용 세트를 구성합니다.

크리에이티브 검토

선택한 광고를 확인해 지원하는 공개 문구, 광고주, 형식, 미디어, 도착 주소 필드를 살펴봅니다.

투명성 아카이빙

정규화된 공개 광고 레코드를 게재 날짜와 수집 정보와 함께 보존합니다.

리서치 정보 보강

검색 결과로 레코드를 파악한 뒤, 알고 있는 공개 광고 URL을 안정적인 상세 필드로 변환합니다.

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

공개 광고 레코드는 원본의 노출 여부, 대상 요건, 지역별 제공 여부, 게시 지연, 보존 기간, 해당 TikTok 서비스가 노출하는 필드에 따라 달라집니다.

  • 검색 결과에 없다고 해서 광고주가 광고를 집행한 적이 없다는 뜻은 아니며, 조회할 수 없는 URL은 상세 결과가 없을 수 있습니다.
  • Search는 국가, 날짜, 섹션, 언어, 업종, 목표, 정보 보강, 정렬 옵션을 제공하지 않습니다.
  • 공개된 날짜, 오디언스, 노출 수 값은 비공개 지출, 전환, 기여도, 광고 수익률 리포트를 대체하지 않습니다.
  • 미디어 참조는 일시적이거나 원본이 제어할 수 있으며, 원본에 의존하는 모든 필드는 null이거나 비어 있을 수 있습니다.

TikTok Ad Library API 자주 묻는 질문

SocQ가 TikTok Ads Manager인가요?

아니요. SocQ는 지원하는 공개 투명성 레코드를 검색하고 정규화할 뿐, 계정, 캠페인, 예산, 타기팅, 크리에이티브를 관리하지 않습니다.

어떤 값을 제출할 수 있나요?

Search는 광고주 이름이나 키워드 하나를 받습니다. Ad Details는 조건에 맞는 알고 있는 공개 TikTok 광고 URL 하나를 받습니다.

모든 결과에 광고 상세 정보가 완전히 들어 있나요?

아니요. Search는 대개 요약 정보를 반환하고, 상세 조회는 레코드를 반환하지 않을 수 있으며, 원본에 의존하는 모든 필드는 null이거나 비어 있을 수 있습니다.

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

반환된 레코드 1건당 0.5 SocQ 크레딧이며 기본 요금은 없습니다. Search의 기본 결과 수는 12건이고 Ad Details는 최대 1건을 반환합니다.

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