Skip to main content

​
Endpoint

POST https://api.ugc.inc/media

​
Overview

Retrieve all media for your organization, including both user-uploaded files and social audio. Supports filtering by specific IDs or tags.

​
Request Body

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

​
Response

​
data
Media[]
Array of media objects (both UserMedia and SocialAudio)
curl -X POST https://api.ugc.inc/media \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tag": "products"
  }'

{
  "ok": true,
  "code": 200,
  "data": [
    {
      "id": "media_abc123",
      "org_id": "org_xyz789",
      "name": "product-video.mp4",
      "tag": "products",
      "type": "video",
      "url": "https://api.ugc.inc/media/file/media_abc123",
      "created_at": "2024-01-15T10:30:00.000Z",
      "media_type": "user_media"
    },
    {
      "id": "audio_def456",
      "org_id": "org_xyz789",
      "name": "Trending Sound",
      "tag": "products",
      "social_post_link": "https://www.tiktok.com/@user/video/123",
      "social_audio_link": "https://www.tiktok.com/music/Trending-Sound-123",
      "platform_type": "tiktok",
      "preview_url": "https://api.ugc.inc/media/file/audio_def456/preview",
      "audio_url": "https://api.ugc.inc/media/file/audio_def456/audio",
      "created_at": "2024-01-14T09:00:00.000Z",
      "media_type": "social_audio",
      "type": "social_audio"
    }
  ]
}