TikTok content-link lookup
TikTok content-link lookup. Follow concrete contracts, examples and reviewable steps using TikTok.
Copy the agent prompt manually
TikTok content lookup
Paste a complete link or identifier, then explicitly run a fictional local sample. The source URL is never requested and no credits are spent.
Use a complete URL or platform identifier. Open short links yourself and copy the complete address. Editing clears the old result and does not execute anything.
Fictional fixture · 0 live calls · 0 charges
Inspect complete JSON
Input and result
This tool maps the task to tiktok.videos.get. Check the input fields below, then run it in the local console; results are fixtures.
Input contract
Inspect meanings, examples and conditional rules for the selected method. view and fields control the response without changing the TEST unit price.
- GET: supply exactly one of id / url.
| Method | Field | Type | Requirement | Meaning | Enum or bound | Example |
|---|---|---|---|---|---|---|
| GET | id | string | Optional / conditional | Video ID, a string of digits | — | "7665840565958872333" |
| GET | url | string | Optional / conditional | Link to the video, pasted as it is: the https://www.tiktok.com/@handle/video/… web link, the www.tiktok.com/t/… or vm.tiktok.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to | — | — |
| GET | view | string | Optional / conditional | How much of each item: compact (the most used fields, long text cut short), standard, or full (adds `ext`). | ["compact","standard","full"] | — |
| GET | fields | array | Optional / conditional | Return only these fields of each item, by path (`author.name`). | maxItems: 64 | — |
Try it locally
Use demo to inspect the fields, then explicitly select simulated with a customer test key to exercise settlement. Never put a customer key in a URL.
{
"capability": "tiktok.videos.get",
"method": "GET",
"params": {
"id": "7665840565958872333"
}
}Output fields and interpretation
The post object permits missing or null values; do not replace missing measurements with zero. This table shows the main structure; the object reference covers nested fields.
| Field | Type | Meaning | Source scope |
|---|---|---|---|
| id | string | null | ID; pass it unchanged to the get endpoint | TikTok |
| url | string | null | Link that opens the post | TikTok |
| type | string | null | Content format | TikTok |
| title | string | null | Title | TikTok |
| text | string | null | Body text | TikTok |
| lang | string | null | Language of the text (standard view and up) | TikTok |
| published_at | string | null | When it was published | TikTok |
| author | object | null | Author | TikTok |
| author.id | string | null | Author's account ID | TikTok |
| author.username | string | null | Author's handle | TikTok |
| author.name | string | null | Author's display name | TikTok |
| author.avatar_url | string | null | Author's avatar (standard view and up) | TikTok |
| author.verified | boolean | null | Whether the author is verified (standard view and up) | TikTok |
| author.followers | integer | null | Author's follower count (standard view and up) | TikTok |
| metrics | object | null | Engagement counts | TikTok |
| metrics.likes | integer | null | Likes | TikTok |
| metrics.comments | integer | null | Comments | TikTok |
| metrics.shares | integer | null | Shares | TikTok |
| metrics.favorites | integer | null | Saves | TikTok |
| metrics.views | integer | null | Views | TikTok |
| metrics.reposts | integer | null | Reposts | TikTok |
| images | array | null | Image addresses (standard view and up) | TikTok |
| hashtags | array | null | Hashtags, without the # (standard view and up) | TikTok |
| mentions | array | null | Accounts mentioned in the text (standard view and up) | TikTok |
| mentions[].id | string | null | Account ID (standard view and up) | TikTok |
| mentions[].username | string | null | Handle (standard view and up) | TikTok |
| mentions[].name | string | null | Display name (standard view and up) | TikTok |
| is_pinned | boolean | null | Whether the author pinned it (standard view and up) | TikTok |
| post_id | string | null | ID of the thread's root post when this is a reply; otherwise null | TikTok |
| parent_id | string | null | ID of the item it replies to directly; otherwise null | TikTok |
| root_id | string | null | ID of the first-level reply its thread hangs under | TikTok |
| approximate | array | null | Which numbers of this item are approximate or lower bounds; absent when all are exact | TikTok |
| approximate[].field | string | null | Path of the field, such as metrics.views | TikTok |
| approximate[].kind | string | null | Approximate, or a lower bound | TikTok |
| ext | object | The platform's own fields (full view). | TikTok |
| ext.duration | number | null | Length of the video, in seconds (full view) | TikTok |
| ext.cover_url | string | null | Address of the cover image (full view) | TikTok |
| ext.video_url | string | null | Address the video plays from: a signed address of the platform's that expires, so use it soon; an image post has none (full view) | TikTok |
| ext.collaborators | array | null | Handles of the co-authors of a collab post other than the one who posted it; an empty list for a post that is not a collab. Brands often collaborate this way, but a collab by itself does not say the post is paid for (full view) | TikTok |
Clear inputs. Inspectable output.
Each click runs a local fixture. Advanced JSON inputs are checked against the selected method. Editing does not execute a request.
Copying does not execute. CLI quote is read-only and needs a local customer TEST key. Configure MCP in demo mode first. GET and POST batches both return only fictional local fixtures.
Download contract example (no execution) ↗For TEST budgets, Key scopes or failure scenarios, open the account console. Customer sandbox ↗