TikTok Ad Library API
검색어로 지원하는 공개 TikTok 광고 레코드를 찾거나, 알고 있는 광고 URL을 정규화된 필드로 확인해 리서치, 검토, 아카이빙에 활용합니다.
사용할 수 있는 TikTok Ad Library API
광고주나 키워드로 공개 광고 레코드를 찾을 때는 Search, 조건에 맞는 공개 광고 URL 하나를 확인할 때는 Ad Details를 사용합니다.
어떤 공개 광고 데이터를 가져올 수 있나요?
반환되는 필드는 각 지원 레코드에서 현재 공개된 정보를 반영하며, 제공되지 않는 원본 값은 null이나 빈 값으로 남습니다.
광고와 광고주 식별 정보
공개 광고 ID, 제공되는 레코드 URL, 광고주 이름, 광고주 참조, 안정적인 리소스 유형을 수집합니다.
크리에이티브와 도착 주소
제공되는 광고 문구, 형식, 미디어 참조, 공개 랜딩 페이지 URL을 확인합니다.
공개된 게재 정보
노출된 경우 지원하는 게재 날짜, 게시 시각, 국가, 플랫폼, 타겟 오디언스, 노출 수 정보를 읽습니다.
수집 정보
검토 대기열, 카탈로그, 리서치 데이터셋에 쓸 수 있도록 정규화된 출처·수집 필드를 보존합니다.
SocQ와 TikTok 광고 제품
SocQ는 지원하는 공개 투명성 레코드를 읽기 전용으로 수집합니다. TikTok의 자체 제품은 공개 라이브러리 접근부터 권한이 부여된 캠페인 관리까지 목적이 서로 다릅니다.
| 기능 | SocQ | TikTok 광고 제품 |
|---|---|---|
| 주요 용도 | 지원하는 공개 광고 레코드 검색과 정규화 | 제품에 따라 공개 투명성 조회 또는 권한이 부여된 캠페인 운영 |
| 입력 | 광고주 또는 키워드 하나, 또는 알고 있는 광고 URL 하나 | 해당 TikTok 서비스에 따라 다름 |
| 비공개 캠페인 데이터 | 제공하지 않음 | 해당 계정, 제품, 승인, 권한이 필요 |
| 작업 | 읽기 전용 공개 데이터 워크플로 | Ads Manager에서 권한이 부여된 캠페인 운영 지원 |
| 응답 형식 | 안정적인 SocQ 광고 레코드 | 제품별 고유 화면 또는 응답 |
TikTok Ad Library API 작동 방식
두 엔드포인트 모두 비동기 제출, 폴링, 읽기 흐름을 따릅니다. Search는 원본 여러 페이지를 수집할 수 있고, Ad Details는 최대 1건을 반환합니다.
1. 엔드포인트 선택
Search에는 광고주나 키워드 하나를, Ad Details에는 조건에 맞는 공개 TikTok 광고 URL 하나를 제출합니다.
2. 작업 폴링
반환된 task_id로 처리가 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.
3. 정규화된 레코드 읽기
data.results.items와 작업 결과 커서를 처리합니다. 상세 요청은 광고 0건 또는 1건을 반환합니다.
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건을 반환합니다.
여러 플랫폼의 데이터를 결합해 더 폭넓은 비즈니스 인사이트를 얻으세요
여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.
YouTube API
지원되는 공개 YouTube 채널 프로필, 동영상 상세 정보, 채널 동영상, 댓글, 쇼츠, 키워드·해시태그 결과, 제공되는 스크립트를 하나의 정규화된 비동기 워크플로로 수집합니다.
Facebook API
공개 Facebook 페이지 프로필, 게시물, 그룹 게시물, 댓글, 키워드에 일치하는 이벤트, 가져올 수 있는 동영상 스크립트를 수집합니다. 식별 정보, 콘텐츠, 출처, 형식, 장소, 미디어, 반응, 참석, 참여도 필드는 정규화되어 제공됩니다.
X API
공개 프로필, 팔로워·팔로잉 관계, 게시물, 답글, 인용, 리포스트한 사용자, 검색 결과, 현재 트렌드를 수집합니다. 일관된 결과를 리서치와 모니터링에 활용하세요.
LinkedIn API
알고 있는 URL에서 공개 LinkedIn 프로필, 기업, 게시물, 채용 공고 데이터를 가져옵니다. 식별 정보, 경력, 기업, 콘텐츠, 참여도, 채용 공고 필드가 정규화되어 제공됩니다.
Reddit API
알고 있는 URL에서 공개 Reddit 게시물과 댓글을 가져오고, 서브레딧의 새 글·인기 글·핫 게시물을 둘러보거나, 키워드와 게시 기간으로 토론을 검색합니다.
Pinterest API
공개 Pinterest 프로필 데이터를 가져오고, 알고 있는 핀을 확인하고, 선택한 프로필의 핀을 수집하거나 키워드로 검색해 크리에이터, 콘텐츠, 비주얼 트렌드를 리서치합니다.

