What is the TikTok Videos API?

TikTok Videos API retrieves publicly accessible video metadata from one or more direct TikTok video URLs. It returns normalized creator, caption, media, music, hashtags, mentions, publication, and engagement data.

How should video links be submitted?

Place one or more direct TikTok video URLs in the urls array. Each URL is processed as a known video lookup.

Can one request process multiple videos?

Yes. urls accepts multiple direct links for batch enrichment of campaign, creator, or competitor video lists.

Which content and creator fields are included?

Results include video ID, canonical URL, caption, language, publication time, hashtags, mentions, and public creator identity and profile fields.

Which public engagement metrics are included?

Results can include like, comment, view, share, save, and repost counts, together with duration, media, and music metadata.

How can collected_at support video comparisons?

Store engagement metrics with collected_at, then compare a selected video set at similar collection times.

How is the TikTok Videos API priced?

Each returned normalized video result costs 0.7 credits.

TikTok Videos API for Content and Performance Data

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 true

Best 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.

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.

Combine TikTok data with public data from other supported social platforms.