tiktok/
search

관련도, 날짜, 좋아요 수, 게시 기간 필터로 키워드에 맞는 공개 TikTok 동영상을 검색하고, 정규화된 크리에이터, 콘텐츠, 미디어, 참여도 레코드를 반환합니다.

TikTok Search API

키워드 탐색
조사용 표본
기간 필터
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Search

TikTok 검색 결과는 키워드나 문구와 일치하는 공개 동영상으로, 크리에이터 정보, 캡션, 미디어, 게시 맥락, 공개된 참여도가 함께 담겨 있습니다. 이러한 레코드는 주제 발굴, 트렌드 조사, 경쟁사 모니터링, 콘텐츠 기회 분석에 활용할 수 있습니다.

TikTok Search API 주요 기능

  • 키워드 기반 동영상 탐색주제, 브랜드, 상품, 이벤트 키워드를 후보 동영상 세트로 바꿉니다.
  • 관련도·최신순 정렬관련도, 날짜, 좋아요 수 정렬을 전환해 주제별, 최신순, 좋아요 많은 순으로 살펴볼 수 있습니다.
  • 게시 기간 지정day, week, month, three_months, six_months로 조사 기간을 정합니다.
  • 콘텐츠 및 크리에이터 필드동영상, 크리에이터, 참여도, 해시태그, 음악 필드를 일관된 검색 결과 구조로 반환합니다.
  • 추적 가능한 검색 스냅샷search_query와 collected_at으로 모든 검색 실험을 기록합니다.

TikTok Search API 매개변수

매개변수필수설명
query필수공개 TikTok 동영상을 찾기 위한 키워드 검색어로, 비어 있지 않아야 하는 필수 값입니다.
results_limit선택요청할 동영상 결과 수의 상한으로, 양수여야 합니다. 기본값은 100입니다.
sort_by선택결과 정렬 기준으로 relevance, date, likes 중에서 선택합니다. 기본값은 relevance입니다.
published_within선택게시 기간 선택 값으로, day, week, month, three_months, six_months 중에서 선택합니다.

TikTok Search API 사용 방법

먼저 조사하려는 질문을 정한 뒤, 키워드와 정렬 목적, 게시 기간을 선택합니다.

  1. 조사 주제를 구체적인 query로 바꾸고, results_limit, sort_by, published_within을 정합니다.
  2. 요청을 /v1/tiktok/search로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 succeeded 또는 failed 상태가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. data.results.items를 읽습니다. has_more가 true이면 next_cursor로 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"space exploration","results_limit":100,"sort_by":"relevance","published_within":"month"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

TikTok Search API 추천 활용 사례

  • 시장·카테고리 탐색: 상품, 카테고리, 활용 사례와 관련된 용어로 TikTok 콘텐츠 지형과 크리에이터 표본을 파악합니다.
  • 이벤트 확산 추적: date 정렬에 day 또는 week 기간을 조합해 출시, 이벤트, 뉴스 시점을 둘러싼 최근 콘텐츠를 따라갑니다.
  • 좋아요 많은 크리에이티브 조사: 좋아요 순으로 정렬해 반복되는 후크, 캡션, 음악 선택, 해시태그 조합을 연구합니다.
  • 브랜드 언급 모니터링: 브랜드와 상품 검색어를 일정에 맞춰 실행하고 스냅샷을 저장해 콘텐츠·커뮤니케이션 팀에 제공합니다.

TikTok Search API 활용 팁

  • 넓은 주제는 브랜드, 니즈, 상황, 트렌드 검색어로 나누어 조회한 뒤 결과 동영상 세트를 병합하세요.
  • 주제를 파악하려면 relevance, 새 게시물을 추적하려면 date, 인기 있는 크리에이티브 패턴을 연구하려면 likes를 선택하세요.
  • 정기 보고서에 week을 쓰는 것처럼, published_within으로 표본의 시간 척도를 일정하게 유지하세요.
  • 검색을 재현할 수 있도록 query, sort_by, published_within, collected_at을 함께 저장하세요.
  • 동영상 id를 기준으로 검색어 간 중복을 제거하되, 해당 동영상과 일치한 search_query는 모두 보관하세요.
  • 핵심 검색어를 일정에 맞춰 반복 실행해 크리에이터, 주제, 참여도의 변화를 비교하세요.

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

  • TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
  • TikTok Hashtags API — 지정한 해시태그의 공개 동영상, 크리에이터, 미디어, 사운드, 참여도를 수집합니다.
  • TikTok Comments API — 공개된 최상위 댓글, 작성자, 참여도, 멘션, 크리에이터 상호작용 플래그를 수집합니다.
  • TikTok Videos API — 동영상 URL에서 크리에이터, 캡션, 미디어, 음악, 태그, 멘션, 참여도를 가져옵니다.
  • TikTok Live Room Info API — 방 ID와 소유자 ID 쌍으로 알고 있는 라이브 방송 하나를 조회하며, 상태, 소유자 맥락, 커버 미디어, 시청자 수를 반환합니다.
  • TikTok Search Users API — 키워드로 공개 TikTok 계정을 검색합니다.

다른 플랫폼 둘러보기

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

TikTok Search API — 자주 묻는 질문

TikTok Search API는 키워드나 문구로 공개적으로 접근할 수 있는 동영상을 찾습니다. 지원되는 정렬 및 기간 필터와 함께 정규화된 동영상, 크리에이터, 캡션, 미디어, 게시 정보, 참여도 데이터를 반환합니다.

query는 비어 있지 않아야 하는 필수 키워드 또는 문구이며, 브랜드, 상품, 캠페인, 인물, 조사 주제 등을 넣을 수 있습니다.

relevance는 주제와의 관련도 순으로 결과를 정리하고, date는 최근 게시물을 우선하며, likes는 공개된 좋아요 성과를 우선합니다. 기본값은 relevance입니다.

published_within에는 day, week, month, three_months, six_months를 지정할 수 있으며, 해당하는 최근 기간에 게시된 동영상이 대상입니다.

results_limit은 요청할 동영상 결과 수의 상한을 정하며, 양의 정수여야 하고 기본값은 100입니다.

결과에는 동영상 ID, 정식 URL, 캡션, 언어, 게시 시각, 크리에이터, 공개 참여도, 해시태그, 멘션, 미디어, 음악 데이터가 포함됩니다.

search_query에는 해당 결과를 만든 검색어가 기록되고, collected_at에는 수집 시각이 기록되어 검색 스냅샷을 추적할 수 있습니다.

정규화된 검색 동영상 결과 1건이 반환될 때마다 0.7 크레딧이 차감됩니다.