TikTok Video Read
Read a public TikTok video by URL through AIAPI Center and return normalized metadata and metrics.
What it does
When an agent has a TikTok URL to inspect, this connector reads it through AIAPI Center using a managed public-data provider and returns normalized metadata, author details, engagement metrics, and hashtags.
Inputs
| Parameter | Format | Example | Required |
|---|---|---|---|
url | string | https://www.tiktok.com/@user/video/1234567890 | Yes |
Outputs
| Field | Type | Description |
|---|---|---|
description | string | Video caption or description |
author | string | Creator nickname or username |
url | string | TikTok video URL |
views | number | Public play count when available |
items | array | One compact video row with metrics and hashtags |
Example output
Input
url: "https://www.tiktok.com/@user/video/1234567890"
Output
# TikTok Video - Description: How I use GPT image prompts - Author: creator_name - URL: https://www.tiktok.com/@user/video/1234567890 - Views: 45,000
What it means
The video was found via the managed Apify provider and returned as a normalized metadata row.
Last tested: 2026-06-28
How to install
Via CLI
Via web
- Visit the connector catalog and find TikTok Video Read.
- Click Install connector and acknowledge any training requirements.
- Complete authorization if prompted.
- Use the connector from Chat or the CLI.
Auth and permissions
| OAuth required | No |
| Managed auth | Included, no API key needed |
| Bring your own key (BYOK) | Not supported in v1 |
| Audit logged | Every request is logged with input, result, cost, and timestamps |
| Training acknowledgment | Not required |
Admins can restrict this connector via blacklist or whitelist in the admin panel.
Limits and edge cases
- •source_mode=third_party_public_search; access_mode=provider_managed.
- •Only public TikTok videos are supported.
- •Metrics may be missing or delayed.
- •Transcript or voice_to_text returned only when the provider supplies it.
Common use cases
Normalize a TikTok URL before agent summarization
Read author, metrics, and hashtags before handing the URL to another agent step.
Frequently asked questions
Does this read private or login-walled videos?
No. Only public TikTok videos are supported.
Related connectors
TikTok Search
Search public TikTok videos through AIAPI Center (Apify managed provider) and return normalized video evidence rows.
YouTube Video Read
Read a public YouTube video by URL or ID through AIAPI Center and return normalized metadata and metrics.
Instagram Post Read
Read a public Instagram post or Reel by URL through AIAPI Center and return normalized metadata and metrics.