# solari fetch tiktok post

> Collect one TikTok post by URL and get its author.

- **CLI**: `solari fetch tiktok post`
- **MCP tool**: `solari_fetch_tiktok_post`
- **Access**: `solari:read` — Available on any SOLARI plan, including the trial. One credit per successful call.
- **Plans**: Any paid plan or trial
- **Credit**: 1

Collect one TikTok post into the SOLARI catalog by its public URL, and learn who posted it. If the post is already stored, nothing is scraped.

**When to use it** — When you were given a post link, catalog content detail says item=null, and you do not know the author.

**What comes back** — Whether it was collected, the post with its author, and the fetch command to crawl that author.

## Parameters

- `url` (string, required, ≤ 512 chars) — Public post URL, including vm.tiktok.com and vt.tiktok.com short links.

## Response

### `Response`

- `ingested` (boolean) — true if this call collected it live.
- `already_tracked` (boolean) — true if it was already in the catalog.
- `fetched_on_demand` (boolean) — Same as ingested.
- `found` (boolean) — false if TikTok has no public post at that URL.
- `post_id` (uuid) — The stored post.
- `account_id` (uuid) — The author's account.
- `username` (string) — The author's handle.
- `item` (object | null) — The post, with assets.
- `note` (string) — What to expect next.
- `next` (string) — Fetch command to crawl the author.

### `item`

- `post_id` (uuid) — TikTok post id. Not interchangeable with Instagram.
- `video_id` (string) — Public numeric id from the TikTok URL.
- `url` (string) — Public permalink.
- `account_id` (uuid) — Author account_id.
- `username` (string) — Author username.
- `post_type` (string) — video or carousel.
- `posted_at` (timestamp) — Published at (UTC).
- `caption` (string) — Caption.
- `duration_seconds` (integer) — Video length.
- `width / height` (integer) — Resolution.
- `play_count` (integer) — Plays.
- `like_count` (integer) — Likes.
- `comment_count` (integer) — Comments.
- `share_count` (integer) — Shares.
- `collect_count` (integer) — Saves.
- `is_ad` (boolean) — TikTok ad flag.
- `is_pinned` (boolean) — Pinned on the profile.
- `aigc_label_type` (string | null) — AI-content label, when TikTok sets one.
- `original_language_code` (string | null) — Source language.
- `cover_url` (string) — Cover image URL.
- `video_url` (string) — Video file URL.
- `images` (string[]) — Carousel slides. Empty for video.
- `hashtags` (string[]) — Hashtags from the caption.
- `mentions` (string[]) — Usernames mentioned in the caption.
- `transcript` (string | null) — Spoken transcript. Only when include_transcript=true.
- `assets` (object[]) — Media files in order. Each has asset_url, media_type, and video_duration.
- `assets[].asset_url` (string | null) — Direct download link to the full-size image or video. Null when no file is stored.

## Example

```console
$ solari fetch tiktok post url=https://www.tiktok.com/@innisfree_official/video/7680375687139642645
```

_Long strings and repeated array entries are trimmed for readability._

```json
{
  "ingested": true,
  "already_tracked": false,
  "fetched_on_demand": true,
  "found": true,
  "post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3900",
  "account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
  "username": "innisfree_official",
  "item": {
    "account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
    "post_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3900",
    "video_id": "7680375687139642645",
    "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
    "username": "innisfree_official",
    "post_type": "video",
    "posted_at": "2026-09-01T09:00:00Z",
    "play_count": 12000,
    "like_count": 800
  },
  "note": "Collected live and stored now. The author is known by name only: run next to crawl their profile and posts.",
  "next": "solari fetch tiktok account username=innisfree_official"
}
```

## As an MCP call

```json
{
  "name": "solari_fetch_tiktok_post",
  "arguments": {
    "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645"
  }
}
```

## Notes

- The author arrives as a name-only account. Run next (fetch tiktok account) to crawl their profile and posts.
- A first-time collect takes a few seconds.

## Related tools

- [`solari_catalog_tiktok_content_detail`](https://finder-dev-pub.bzine.co/docs/tools/catalog-tiktok-content-detail.md)
- [`solari_fetch_tiktok_account`](https://finder-dev-pub.bzine.co/docs/tools/fetch-tiktok-account.md)
- [`solari_fetch_tiktok_posts`](https://finder-dev-pub.bzine.co/docs/tools/fetch-tiktok-posts.md)