tiktok · catalog · contentsolari:read
solari catalog tiktok content search
수집된 TikTok 캡션과 영상 자막을 기간으로 검색할 때 쓰세요.
- MCP 도구
- solari_catalog_tiktok_content_search
- CLI
- solari catalog tiktok content search
- 권한
- solari:read
- 이용 가능 플랜
- 무료 체험
- Plus
- Pro
- Enterprise
- 크레딧
- 1
개요
SOLARI가 수집하는 KR, JP, US, TW 지역 TikTok 게시물을 키워드로 검색합니다. 최근 6개월 정도가 대상입니다. TikTok 카탈로그는 작으니 fetch tiktok post search부터 시작하고, 기간 조건이 필요할 때 이 도구를 쓰세요.
언제 쓰나요 — 특정 기간의 TikTok 게시물이나, 영상에서 특정 내용을 말한 게시물을 찾을 때 쓰세요. 주제로 게시물을 찾을 때는 fetch tiktok post search부터 쓰세요.
돌려주는 값 — 관련도순 게시물 목록. 일치한 부분이 강조 표시됩니다.
파라미터
- querystring필수
- 검색어.
- regionenum선택
- KR, JP, US, TW 중 하나.기본값
"KR"값KRJPUSTW - limitinteger선택
- 한 페이지에 가져올 게시물 수.기본값
201–100 - offsetinteger선택
- 건너뛸 게시물 수.기본값
00–9800 - sincestring선택
- 이 날짜(UTC, YYYY-MM-DD) 이후에 올라온 게시물만 가져옵니다. 당일 포함.pattern ^\d{4}-\d{2}-\d{2}$
- untilstring선택
- 이 날짜(UTC, YYYY-MM-DD) 이전에 올라온 게시물만 가져옵니다. 당일 포함.pattern ^\d{4}-\d{2}-\d{2}$
응답
Response
- query / regionstring
- 적용된 검색어와 지역.
- totalinteger
- 일치한 게시물 수. 10,000까지는 정확하고, 넘으면 10,000으로 표시됩니다.
- took_msinteger
- 검색에 걸린 시간.
- itemsobject[]
- 검색 결과. 점수가 높은 순.
items[]
- post_id / video_id / urlstring
- 게시물 식별자와 공개 링크.
- account_id / usernamestring
- 작성한 계정.
- captionstring
- 캡션.
- user_biostring
- 작성자 소개글.
- transcription_textstring | null
- 영상 자막. 검색 대상 텍스트에 포함됩니다.
- transcription_languagestring | null
- 영상 자막의 언어 코드.
- post_typestring
- video 또는 carousel.
- posted_attimestamp
- 게시 시각(UTC).
- duration_secondsinteger
- 영상 길이.
- play_count / like_count / comment_count / share_count / collect_countinteger
- 참여 지표.
- follower_countinteger
- 작성자 팔로워 수.
- is_adboolean
- TikTok이 직접 표시한 광고 여부.
- cover_urlstring
- 커버 이미지.
- scorenumber
- 관련도 점수.
- highlightobject
- 필드별로 일치한 부분.
- assetsobject[]
- 미디어 파일 목록(순서대로). 각 항목에 asset_url, media_type, video_duration이 있습니다.
- assets[].asset_urlstring | null
- 원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null.
- region_inferredboolean
- 작성자의 국가를 몰라서 캡션 언어로 지역을 정한 게시물이면 true입니다.
예시
요청
$ solari catalog tiktok content search query="올리브영 세일" limit=3응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다.
{
"query": "올리브영 세일",
"region": "KR",
"total": 4041,
"took_ms": 29,
"items": [
{
"post_id": "01a05c46-9a08-7e92-a40e-b1a039103118",
"video_id": "7679484556189207815",
"url": "https://www.tiktok.com/@flos_bonita/video/7679484556189207815",
"account_id": "0196cb39-87a7-7be3-ac4a-4a80b7818a90",
"username": "flos_bonita",
"caption": "태닝한 산리오 키링이라니…☀️🥹💗 푸드올로지 X 산리오 콜라보 실물 너무 귀엽잖아!! 헬로키티·쿠로미·한교동·마이멜로디까지🎀 제품마다 다른 키링이라 산리오 덕후들 취향 제대로 저격💘 올영 세일 시작했으니 얼른 구경해봐요👀🛒 #푸드올로지 #태닝키티 #올리브영추천템 #올영세일",
"user_bio": "화미 프로필 링크",
"transcription_text": "살리오 덕후라면 절대 그냥 넘길 수 없는 영상 오늘부터 시작인 올리브영 세일과 함께 푸드올로지와 살리오 콜라보 나왔어요 이번 콜라보는 젤리 폼 앰플 젤리 3 종으로 피디아렌 앰플 젤리 글루타치원 씨 앰플 젤리 히알루론산 앰플 젤리까지 제품마다 귀여운 살리오 굿즈도 함께 만나 볼 수 있는데 헬로키티 크로미 한교동부터 마이 멜로디까지 저는 역시 헬로키티 더 쿠답게 키티 키링으로 폼구 최애 캐릭터 …",
"transcription_language": "ko",
"post_type": "video",
"posted_at": "2026-08-29T16:02:22Z",
"duration_seconds": 37,
"play_count": 955,
"like_count": 26,
"comment_count": 0,
"share_count": 0,
"collect_count": 5,
"follower_count": 1345,
"is_ad": true,
"cover_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-p-0037/oEu4VAolaEBAAYjMAjBtiyCIAABiPp9TOCAME~tplv-tiktokx-origin.image?dr=10395&x-expires=1788426000&x-signature=FAP0C10M1M1gEwD4YMB03pYd0YA%3D&t=4d5b0474&ps=13740610&sh …",
"score": 53.787056,
"highlight": {
"caption": [
"헬로키티·쿠로미·한교동·마이멜로디까지🎀 제품마다 다른 키링이라 산리오 덕후들 취향 제대로 저격💘 올<mark>영</mark> <mark>세일</mark> 시작했으니 얼른 구경해봐요👀🛒 #푸드올로지 #태닝키티 #올리브영추천템 #올영세일"
],
"user_bio": [],
"transcription_text": [
"살리오 덕후라면 절대 그냥 넘길 수 없는 영상 오늘부터 시작인 <mark>올리브</mark><mark>영</mark> <mark>세일</mark>과 함께 푸드올로지와 살리오 콜라보 나왔어요 이번 콜라보는 젤리 폼 앰플 젤리 3 종으로 피디아렌 앰플 젤리 글루타치원 씨 앰플 젤리 히알루론산 앰플 젤리까지 제품마다 귀여운 살리오 굿즈도 함께",
"… 1 more"
]
}
},
"… 2 more"
]
}MCP 호출
{
"name": "solari_catalog_tiktok_content_search",
"arguments": {
"query": "올리브영 세일",
"limit": 3
}
}주의사항
- offset은 최대 9,800입니다. 더 뒤까지 보려면 기간을 좁히세요.
- total은 10,000까지만 셉니다.
- 작성자의 국가를 모르면 캡션 언어에 맞는 지역에 넣고 region_inferred=true를 붙입니다.