TikTok Song Videos
Tracking video posts linked to a shared audio track reveals how creators interpret viral challenges and trending background music. Normalized video items return creator context, captions, playback links, and visible engagement metrics across each sound cluster.
Features
- Sound-centric video collectionSubmit one or more numeric sound clip IDs to gather videos published under that exact audio identity.
- Creator and post contextCapture creator username, nickname, full caption text, hashtags, and mentions for each returned video.
- Engagement breakdownExtract view, like, comment, share, and save counts to compare performance among videos using the same track.
- Media download linksReceive direct cover image and video stream URLs with dimensions and duration metadata.
Parameters
| Parameters | Required | Description |
|---|---|---|
music_ids | Required | Array of numeric TikTok sound clip IDs to collect public videos for. |
results_limit | Optional | Maximum number of videos to return per sound ID; defaults to 100 with an allowed range of 1 to 2,000. |
How to Use
Submit a list of sound clip IDs as an asynchronous task, then paginate through normalized video results.
- Provide an array of numeric clip IDs in music_ids and an optional results_limit up to 2,000.
- Send a POST request to /v1/tiktok/song-videos with your SocQ API key.
- Poll /v1/tasks/{task_id} until the status is succeeded.
- Read data.results.items and follow next_cursor for additional pages.
curl -X POST "https://api.socq.ai/v1/tiktok/song-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"music_ids":["7439295283975702544"],"results_limit":20}'
# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.Best Use Cases
- Viral sound campaign analysis: Evaluate how effectively a branded sound or promotional audio track is spreading across creator communities.
- Creative pattern research: Analyze common visual formats, choreography, or skits adopted by creators using the same audio snippet.
- High-performing UGC discovery: Identify top-performing user-generated videos associated with specific trending music for licensing or collaboration.
Pro Tips
- Obtain the numeric music_id from the TikTok Song endpoint or the end of a TikTok music web URL.
- Results are returned in reverse-chronological order or popularity according to platform sound feeds.
- Use results_limit to cap results per sound; multi-ID tasks paginate each sound ID independently.
- Check extra.clip_id on each video item to correlate items back to the input sound ID.
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 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.
- TikTok Search Users API
- TikTok Song API