for agents
← All tools
tiktok · fetch · postsolari:read

solari fetch tiktok post assets

Original-size download links for one TikTok post.

MCP tool
solari_fetch_tiktok_post_assets
CLI
solari fetch tiktok post assets
Access
solari:read
Plans
  • Free Trial
  • Plus
  • Pro
  • Enterprise
Credit
1

Overview

Get fresh download links for the media of one TikTok post, at the largest size TikTok serves: the video, or every photo of a photo post. Every call reads the post from TikTok live.

When to use it — When you need the original files of a post. The assets on other tools point at stored copies, which can be smaller.

What comes back — The post's author and type, and one download link per media file in order.

Parameters

urlstringoptional
Public post URL, including vm.tiktok.com and vt.tiktok.com short links. Wins over video_id.≤ 512 chars
video_idstringoptional
Numeric video id. Only for posts already in the catalog; use url otherwise.pattern ^\d{15,20}$

Response

Response

foundboolean
false if TikTok has no public post at that reference.
video_idstring | null
Public numeric id of the post.
urlstring | null
Public permalink.
usernamestring | null
The author's handle.
post_typestring | null
video or carousel.
media_countinteger
Number of files in assets.
assetsobject[]
The media files in order.
notestring | null
Why there is nothing to download, when that is the case.

assets[]

indexinteger
Position of the file in the post, from 1.
media_typestring
video or image.
asset_urlstring
Download link for the file at the largest size the platform serves. It is temporary, so download promptly.
fallback_urlsstring[]
Other links to the same file, to try in order when asset_url fails.
widthinteger | null
Width in pixels, when known.
heightinteger | null
Height in pixels, when known.
video_durationnumber | null
Video length in seconds.
file_extensionstring
File extension to save with, such as mp4 or jpg.
size_bytesinteger | null
File size in bytes, when known.
refererstring | null
Send this as the Referer header when downloading. Null when no header is needed.

Example

Request

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

Response · Long strings and repeated array entries are trimmed for readability.

{
  "found": true,
  "slug": null,
  "video_id": "7680375687139642645",
  "url": "https://www.tiktok.com/@innisfree_official/video/7680375687139642645",
  "username": "innisfree_official",
  "post_type": "video",
  "media_count": 1,
  "assets": [
    {
      "index": 1,
      "media_type": "video",
      "asset_url": "https://www.tiktok.com/aweme/v1/play/?…",
      "fallback_urls": [
        "https://www.tiktok.com/aweme/v1/play/?…"
      ],
      "width": 1080,
      "height": 1920,
      "video_duration": 23,
      "file_extension": "mp4",
      "size_bytes": 2775677,
      "referer": "https://www.tiktok.com/"
    }
  ],
  "note": null
}

As an MCP call

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

Notes

  • To save the files in one step, run solari tiktok download content urls=… dir=… instead. It calls this tool and downloads every file.
  • TikTok rejects a video download without the Referer header, so send the referer value with the request.
  • The links are temporary signed links. Download promptly and call again for fresh ones.

Related tools

Machine-readable: /docs/tools/fetch-tiktok-post-assets.md