Skip to main content

​
Endpoint

POST https://api.ugc.inc/media/social-audio

​
Overview

Retrieve social audio files imported from TikTok. Returns only social audio, not user-uploaded media. Supports filtering by specific IDs or tags.

​
Request Body

​
ids
string[]
Filter to specific social audio IDs. Returns only audio matching these IDs.
​
tag
string
Filter social audio by tag

​
Response

​
data
SocialAudio[]
Array of social audio objects
curl -X POST https://api.ugc.inc/media/social-audio \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tag": "trending"
  }'

{
  "ok": true,
  "code": 200,
  "data": [
    {
      "id": "audio_abc123",
      "org_id": "org_xyz789",
      "name": "Trending Sound - Artist",
      "tag": "trending",
      "social_post_link": "https://www.tiktok.com/@user/video/1234567890",
      "social_audio_link": "https://www.tiktok.com/music/Trending-Sound-1234567890",
      "platform_type": "tiktok",
      "preview_url": "https://api.ugc.inc/media/file/audio_abc123/preview",
      "audio_url": "https://api.ugc.inc/media/file/audio_abc123/audio",
      "created_at": "2024-01-15T10:30:00.000Z",
      "media_type": "social_audio",
      "type": "social_audio"
    }
  ]
}