TikTok Trending Feed
TikTok Trending Feed videos are public feed entries exposed for a regional context, with video and creator identity, captions, cover images, timestamps, and visible engagement. These content and performance signals support regional discovery snapshots, creative research, and point-in-time comparisons.
Features
- Region-scoped public feedAccept a non-empty region value and collect the current public video feed exposed for that regional request context.
- Normalized video and creator detailReturn video IDs and source URLs, captions, creator identity, cover-image references, and creation and collection timestamps in consistent records.
- Visible engagement metricsKeep public view, like, comment, share, and save counts together for each returned video.
- Bounded current snapshotSlice one regional feed response to results_limit without following source continuation, retaining a current feed sample rather than ranks or historical series.
Parameters
| Parameters | Required | Description |
|---|---|---|
region | Required | Required non-empty region value. The backend trims and uppercases it; use a standard two-letter region code such as US for the intended regional context. |
results_limit | Optional | Optional integer cap from 4 through 2,000; defaults to 100 and slices the single feed response, which can contain fewer videos. |
How to Use
Submit a regional feed request as an asynchronous task, then read its normalized videos with task-result cursor pagination.
- Enter a non-empty region value; use a standard two-letter code such as US for the intended regional context, and choose a results_limit from 4 through 2,000 or keep the default of 100.
- POST region and results_limit to /v1/tiktok/trending-feed, then save the returned task_id.
- Poll /v1/tasks/{task_id} until the status becomes succeeded or failed.
- 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/trending-feed" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region":"US","results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.Best Use Cases
- Capture a regional discovery snapshot: Store video IDs, source URLs, captions, creators, and collected_at from one regional feed request to document the publicly exposed set at collection time.
- Sample current creative patterns: Review captions, creator names, cover images, and creation times to compare the visible creative mix in a selected regional feed.
- Compare visible engagement: Use view, like, comment, share, and save counts with collected_at to compare public engagement signals across returned videos.
Pro Tips
- Use a standard two-letter region code even though the current runtime only requires a non-empty value; the backend trims whitespace and converts it to uppercase.
- Choose results_limit as a cap rather than an expected count, because the endpoint slices one feed response and does not request source continuation pages.
- Treat region as feed-availability context, not proof of a video's origin; extra.region is row-level data and can be empty or differ from the request.
- Use task result cursors only to page records already saved by SocQ; they do not fetch another page from the regional feed.
- When comparing repeated runs, deduplicate by video id and retain collected_at because feed membership and ordering can change between requests.
- Handle creator fields, metrics, cover media, timestamps, and extra values as nullable, and escape public captions before displaying them.
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 Videos API — Retrieve creator, caption, media, music, tags, mentions, and engagement from video URLs.
- 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 Video Transcript API — Extract available transcript text, language, format, and source context from public video URLs.
Combine TikTok data with public data from other supported social platforms.