tiktok · catalog · contentsolari:read
solari catalog tiktok content batch
TikTok 게시물 여러 개를 한 번에.
- MCP 도구
- solari_catalog_tiktok_content_batch
- CLI
- solari catalog tiktok content batch
- 권한
- solari:read
- 이용 가능 플랜
- 무료 체험
- Plus
- Pro
- Enterprise
- 크레딧
- 1
개요
TikTok 게시물 id 목록으로 캡션과 지표를 한 번에 불러옵니다. 찾을 수 없는 id는 건너뜁니다.
언제 쓰나요 — 검색이나 계정 게시물 목록에서 얻은 id를 한꺼번에 불러오고 싶을 때 쓰세요.
돌려주는 값 — 찾은 게시물 목록.
파라미터
- post_idsuuid[]필수
- 불러올 TikTok 게시물 id. 최대 100개.1–100 items, uuid
- sortenum선택
- 최신순 또는 참여순으로 정렬합니다.기본값
"recent"값recentengagement - include_transcriptboolean선택
- 영상 자막을 함께 가져옵니다.기본값
false
응답
Response
- requestedinteger
- 보낸 id 수.
- foundinteger
- 찾은 id 수.
- itemsobject[]
- 찾은 게시물 목록.
items[]
- post_iduuid
- TikTok 게시물 id. Instagram 게시물 id와 섞어 쓸 수 없습니다.
- video_idstring
- TikTok URL에 들어 있는 공개 숫자 id.
- urlstring
- 공개 고유 링크.
- account_iduuid
- 작성자 account_id.
- usernamestring
- 작성자 username.
- post_typestring
- video 또는 carousel.
- posted_attimestamp
- 게시 시각(UTC).
- captionstring
- 캡션.
- duration_secondsinteger
- 영상 길이.
- width / heightinteger
- 해상도.
- play_countinteger
- 재생 수.
- like_countinteger
- 좋아요 수.
- comment_countinteger
- 댓글 수.
- share_countinteger
- 공유 수.
- collect_countinteger
- 저장 수.
- is_adboolean
- TikTok이 표시한 광고 여부.
- is_pinnedboolean
- 프로필에 고정된 게시물인지 여부.
- aigc_label_typestring | null
- AI 생성 콘텐츠 표시. TikTok이 붙인 경우에만 있습니다.
- original_language_codestring | null
- 원문 언어.
- cover_urlstring
- 커버 이미지 URL.
- video_urlstring
- 영상 파일 URL.
- imagesstring[]
- 캐러셀 슬라이드. 영상이면 비어 있습니다.
- hashtagsstring[]
- 캡션에 들어 있는 해시태그.
- mentionsstring[]
- 캡션에서 언급한 username.
- transcriptstring | null
- 영상 자막. account posts와 content batch에서는 include_transcript=true일 때만 옵니다.
- assetsobject[]
- 미디어 파일 목록(순서대로). 각 항목에 asset_url, media_type, video_duration이 있습니다.
- assets[].asset_urlstring | null
- 원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 null.
예시
요청
$ solari catalog tiktok content batch post_ids='["01a0631e-f0df-7e9d-a09b-d84bc31d3834"]'응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다.
{
"requested": 1,
"found": 1,
"items": [
{
"post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
"video_id": "7680375687139642645",
"url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
"account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
"username": "innisfree_official",
"post_type": "video",
"posted_at": "2026-09-02T12:00:00Z",
"caption": "Deeply hydrated skin—NO OFF HOURS. 💚 wherever the day takes MINGYU—his hydration stays SUPERCHARGED ⚡️ Green Tea Ceramide Milk: Lightweight milky toner that won't clog your pores Green Tea Ceramide Mist: Touch-free, fa …",
"duration_seconds": 23,
"width": 1080,
"height": 1920,
"play_count": 493,
"like_count": 37,
"comment_count": 2,
"share_count": 0,
"collect_count": 3,
"is_ad": false,
"is_pinned": false,
"aigc_label_type": null,
"original_language_code": null,
"cover_url": "https://smr-images-b.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/cover.jpg",
"video_url": "https://smr-images-b.bzine.co/tiktok/users/019b2137-f76e-7b33-9437-26044fa7b1ed/posts/01a0631e-f0df-7e9d-a09b-d84bc31d3834/medias/origin.mp4",
"images": [],
"hashtags": [],
"mentions": [],
"transcript": null
}
]
}MCP 호출
{
"name": "solari_catalog_tiktok_content_batch",
"arguments": {
"post_ids": [
"01a0631e-f0df-7e9d-a09b-d84bc31d3834"
]
}
}주의사항
- SOLARI 게시물 id만 받습니다. 숫자로 된 영상 id는 content detail에 video_id로 넣으세요.
- TikTok 게시물 id와 Instagram 게시물 id는 섞어 쓸 수 없습니다.