tiktok/
search-photos

동영상은 빼고 키워드로 TikTok 사진 캐러셀만 검색해, 슬라이드 이미지 전체와 캡션, 해시태그, 크리에이터, 조회수·좋아요·댓글·공유 수를 받습니다.

TikTok Photo Search API

키워드 검색
사진 게시물만
캐러셀 이미지 전체
결과당 0.6 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Photo Search

TikTok 사진 게시물은 옆으로 넘겨 보는 정지 이미지 묶음에 캡션, 해시태그, 사운드를 붙여 올린 것으로, 동영상과 똑같이 조회수·좋아요·댓글·공유 수가 쌓입니다. 사진 게시물만 검색하면 코디 모음, 레시피 단계, 리스트형 정보, 상품 모음 등 한 주제에서 어떤 시각적 형식이 반응을 얻는지 한눈에 보입니다.

TikTok Photo Search API 주요 기능

  • 사진 게시물만 검색결과가 전부 사진 캐러셀이고 동영상은 제외되므로, 키워드 검색이 동영상 결과에 묻히지 않습니다.
  • 슬라이드마다 크기 정보 포함media에 게시물의 이미지가 슬라이드 순서대로 나열되며, 이미지마다 type, url, width, height가 들어 있습니다.
  • 반응과 게시물 맥락metrics에 좋아요, 댓글, 공유, 재생, 조회 수치가 있고, 게시물마다 텍스트 캡션, 해시태그, 멘션, 오디오, 크리에이터 프로필 필드가 함께 옵니다.

TikTok Photo Search API 매개변수

매개변수필수설명
query필수사진 게시물을 찾을 키워드입니다.
results_limit선택반환할 사진 게시물의 개수로, 1~500 사이 값입니다. 기본값은 20입니다.

TikTok Photo Search API 사용 방법

키워드를 검색하고 일치하는 사진 게시물을 페이지 단위로 읽습니다.

  1. {"query": "outfit ideas", "results_limit": 20}을 /v1/tiktok/search-photos로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items에서 사진 게시물을 읽고, has_more가 true인 동안 results.next_cursor를 다시 보내 이어서 가져옵니다.
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"outfit ideas","results_limit":20}'

# media holds every image of each carousel, in slide order.

TikTok Photo Search API 추천 활용 사례

  • 슬라이드 구성 벤치마킹: 한 키워드의 캐러셀들을 대상으로 media의 이미지 수와 좋아요·댓글·공유·조회수를 비교하면, 몇 장짜리가 반응이 좋은지 알 수 있습니다.
  • 캡션과 해시태그 조사: 키워드별로 반응이 가장 좋은 사진 게시물의 text와 hashtags를 읽어, 성과가 나는 콘텐츠에 크리에이터가 어떤 문구와 태그를 쓰는지 살펴봅니다.
  • 비주얼 트렌드 보드 만들기: outfit ideas 같은 키워드의 상위 게시물에서 슬라이드 이미지를 모아, 패션·음식·여행 콘텐츠의 레퍼런스 보드를 만듭니다.

TikTok Photo Search API 활용 팁

  • 게시물 순위는 좋아요 수만 보지 말고, 좋아요·댓글·공유를 합한 값을 views_count로 나눠 매기세요. 작은 계정의 반응 좋은 게시물이 큰 계정에 묻히지 않습니다. views_count가 비어 있거나 0인 게시물은 건너뛰세요.
  • 한 주제의 표현마다 별도 쿼리로 실행하세요. 예를 들어 outfit ideas와 ootd를 따로 검색하고, 합칠 때는 id로 중복을 제거합니다. 슬라이드 하나가 여러 검색어에 걸릴 수 있습니다.
  • 파일이 필요하면 작업이 끝난 직후 슬라이드 이미지를 내려받으세요. TikTok은 이미지를 서명된 링크로 제공하고, 이 링크는 일정 시간이 지나면 만료됩니다.
  • 게시물은 audio.title이 아니라 audio.id로 묶으세요. 사진 게시물은 크리에이터 본인의 사운드를 쓰는 경우가 많고, 그 제목은 흔한 원본 사운드 표기에 불과합니다.

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

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

다른 플랫폼 둘러보기

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

TikTok Photo Search API — 자주 묻는 질문

TikTok Photo Search API는 키워드로 TikTok 사진 캐러셀 게시물을 검색하는 프로그래밍 인터페이스입니다. 게시물별 이미지 전체와 함께 캡션, 크리에이터, 해시태그, 조회수·좋아요·댓글·공유 수를 반환합니다.

이 엔드포인트는 사진 캐러셀만 반환하며 동영상은 결과에서 제외됩니다.

실질적으로 같습니다. TikTok은 이 형식을 사진 게시물 또는 포토 모드라고 부르고, 크리에이터들은 슬라이드쇼나 캐러셀이라고 부릅니다. 여기서 결과 하나가 이런 게시물 하나이며, 슬라이드는 media에 들어 있습니다.

전부입니다. media에 모든 이미지가 슬라이드 순서대로 나열되며, 각각 url, width, height가 있습니다.

아니요. 좋아요, 댓글, 공유, 재생, 조회 수치는 나오지만 저장 수는 포함되지 않습니다.

Top Search는 한 키워드에 대해 동영상과 사진 캐러셀을 섞어서 반환하고, Photo Search는 캐러셀만 남기므로 모든 결과의 media에 이미지가 들어 있습니다.

results_limit은 1~500을 받으며 기본값은 20입니다. 반환된 사진 게시물 1개당 0.6 크레딧이 청구되고, 일치하는 사진 게시물이 없는 검색은 비용이 들지 않습니다.