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 사용 방법
키워드를 검색하고 일치하는 사진 게시물을 페이지 단위로 읽습니다.
- {"query": "outfit ideas", "results_limit": 20}을 /v1/tiktok/search-photos로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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로 묶으세요. 사진 게시물은 크리에이터 본인의 사운드를 쓰는 경우가 많고, 그 제목은 흔한 원본 사운드 표기에 불과합니다.
관련 API
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 Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API