get_v1_media_by_url
Retrieve TikTok video details using a TikTok URL. Returns the video object, which provides the ID needed for comment tools.
Instructions
Get a TikTok video by its link. Use it when you have a tiktok.com URL; use get_v1_media_by_id when you already have the numeric video id. Returns the video object; pass its id to the comment tools. Live request to TikTok, billed per call. (GET /v1/media/by/url)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "get_v1_media_by_url"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | A TikTok media link. Accepted forms: 'https://www.tiktok.com/@username/video/7329151448644734213', 'https://www.tiktok.com/@username/photo/7563287743757962503', '/@username/video/7329151448644734213', 'https://vm.tiktok.com/ABCDEfghK/' (also vt.tiktok.com and /t/<code>). A profile, hashtag or non-TikTok link is answered 400. |