TikTok Videos
TikTok Videos are short-form posts with captions, creator context, media, music, duration, hashtags, mentions, publication details, and visible engagement. These content signals support trend research, creative analysis, campaign review, and performance comparison.
Features
- Batch video URL lookupConvert a batch of TikTok video links into consistent content records.
- Stable video identityResolve video identity and source through video ID and canonical URL.
- Content and creator fieldsExtract caption, language, publication time, creator, duration, and cover context.
- Creative context fieldsBring hashtags, mentions, music, and content flags into creative analysis.
- Point-in-time metricsPair visible engagement counts with collected_at for performance snapshots.
Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Required list of direct TikTok video URLs that are currently publicly accessible. |
How to Use
Turn links from bookmarks, reports, or internal systems into an analysis-ready video inventory.
- Gather direct video links, normalize their URL format, and deduplicate the list.
- POST the urls array to /v1/tiktok/videos and save the returned task_id.
- Poll /v1/tasks/{task_id} until the task reaches succeeded or failed.
- Read data.results.items. When has_more is true, continue with next_cursor.
curl -X POST "https://api.socq.ai/v1/tiktok/videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.tiktok.com/@nasa/video/7412345678901234567"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Content pattern analysis: Combine captions, hashtags, mentions, music, and duration to compare recurring elements across selected videos.
- Campaign video reporting: Capture views and engagement for a selected asset set and compare campaign performance consistently.
- Video asset catalogs: Index content by video ID, canonical URL, cover, creator, and publication time for fast retrieval.
- Topic and format tagging: Use language, captions, hashtags, and music to classify themes, formats, and intended audiences.
Pro Tips
- Merge duplicate assets by id and retain url for review and source navigation.
- Store published_at as the release time and collected_at as the metric snapshot time.
- Combine caption, hashtags, mentions, and music into searchable content features.
- When views is present and greater than zero, use it as the denominator for like, comment, and share ratios.
- Join Comments records to the same video ID to compare asset performance with audience response.
- Collect a comparison set close together in time so engagement snapshots remain meaningful.
Related APIs
Use these APIs when you need a different type of public TikTok data.
- TikTok Profiles API — Retrieve public profile identity, biographies, account flags, and audience counts by username.
- TikTok Hashtags API — Collect public videos, creators, media, sound, and engagement for specified hashtags.
- TikTok Comments API — Collect public top-level comments, authors, engagement, mentions, and creator interaction flags.
- TikTok Search API — Search public videos by keyword with supported sorting and publication filters.
- TikTok Comment Replies API — Collect public replies for a known comment using its TikTok video URL and comment ID, with authors, engagement, timestamps, and parent context.
- TikTok Followers List API — Collect normalized profiles visible in public follower lists, with retained source context and supported metrics.
- TikTok Following List API — Collect public profiles followed by TikTok accounts with normalized identity, biographies, visible metrics, and source-account context.
- TikTok User Videos API — Collect public profile-feed videos by username with captions, creators, media, timestamps, engagement, and source-account context.
- TikTok Live Room Info API — Look up one known live room by paired room and owner IDs, returning status, owner context, cover media, and audience counts.
- TikTok Trending Feed API — Collect the current public video feed for a region with creator, caption, cover, timestamp, and visible engagement fields.
- TikTok Video Transcript API — Extract available transcript text, language, format, and source context from public video URLs.