TikTok User Videos API

TikTok User Videos

Features

• Known-account profile feedsAccept one or more TikTok usernames and traverse each public video feed independently, keeping results scoped to selected accounts rather than keyword or hashtag discovery.
• Video and creator detailReturn video IDs and URLs, captions, language, creator identity, media references, duration, hashtags, mentions, music, and public content flags.
• Time-stamped engagement signalsPair visible view, like, comment, share, save, and repost counts with publication and collection times for point-in-time account video records.
• Controlled per-account traversalApply latest or popular ordering and an optional region to each username while deduplicating video IDs and enforcing the requested per-account limit.

Parameters

How to Use

Submit known public usernames as an asynchronous task, then read the normalized account-linked videos with result cursor pagination.

1. Prepare one or more public TikTok usernames and choose latest or popular ordering, an optional two-letter region, and a per-username results_limit.
2. POST usernames and the optional controls to /v1/tiktok/user-videos, then save the returned task_id.
3. Poll /v1/tasks/{task_id} until the status becomes succeeded or failed.
4. Read data.results.items from /v1/tasks/{task_id}?limit=50 and continue with results.next_cursor while results.has_more is true.

curl -X POST "https://api.socq.ai/v1/tiktok/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@loganpaul"],"results_limit":20,"sort_by":"latest"}'

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

Best Use Cases

• Creator video inventories: Index selected accounts by video ID, canonical URL, caption, media, publication time, and extra.input_username to maintain a traceable public content catalog.
• Publishing and engagement comparison: Compare created_at with visible views, likes, comments, shares, saves, and reposts across known accounts while retaining collected_at as the snapshot time.
• Creative format research: Use captions, language, duration, hashtags, mentions, music, media type, and public content flags to compare recurring creative patterns in selected profile feeds.

Pro Tips

• Normalize every handle to one form and deduplicate before submission, because creator and @creator address the same account but can otherwise be processed separately.
• Choose results_limit with the username count in mind, because the limit and initial credit estimate apply independently to every submitted account.
• Use latest for recency-oriented collection, and treat popular as source ordering rather than a score calculated by SocQ.
• Use region only as an availability control; do not interpret it as proof that a returned video was produced in that geography.
• When combining repeated tasks, deduplicate by video id while retaining extra.input_username and collected_at for account attribution and snapshot timing.
• Treat optional creator, engagement, media, music, and content-flag fields as nullable, escape public captions before display, and avoid assuming source media URLs are permanent.

Related APIs