curl -X POST https://api.ugc.inc/media/social-audio/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.tiktok.com/@username/video/1234567890",
    "tag": "trending"
  }'

import requests

# Import from TikTok video URL
response = requests.post(
    'https://api.ugc.inc/media/social-audio/upload',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'url': 'https://www.tiktok.com/@username/video/1234567890',
        'tag': 'trending'
    }
)

# Import from Instagram reel URL
response = requests.post(
    'https://api.ugc.inc/media/social-audio/upload',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'url': 'https://www.instagram.com/reel/ABC123xyz/',
        'tag': 'instagram-audio'
    }
)

data = response.json()

if data['ok']:
    audio = data['data']
    print(f"Imported: {audio['name']}")
    print(f"Audio URL: {audio['audio_url']}")
    print(f"Cover URL: {audio['preview_url']}")

// Import from Instagram audio page URL
const response = await fetch('https://api.ugc.inc/media/social-audio/upload', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://www.instagram.com/reels/audio/1234567890/',
    tag: 'music'
  })
});

const data = await response.json();

if (data.ok) {
  console.log('Imported:', data.data.name);
  console.log('Audio URL:', data.data.audio_url);
}

import { UGCClient } from 'ugcinc';

const client = new UGCClient({
  apiKey: 'YOUR_API_KEY'
});

// Import from TikTok video URL
const response = await client.media.createSocialAudio({
  url: 'https://www.tiktok.com/@username/video/1234567890',
  tag: 'trending'
});

// Import from Instagram reel URL
const igResponse = await client.media.createSocialAudio({
  url: 'https://www.instagram.com/reel/ABC123xyz/',
  tag: 'instagram-audio'
});

if (response.ok) {
  console.log('Imported:', response.data.name);
  console.log('Audio URL:', response.data.audio_url);
  console.log('Cover URL:', response.data.preview_url);
}

{
  "ok": true,
  "code": 200,
  "data": {
    "id": "audio_abc123",
    "org_id": "org_xyz789",
    "name": "Trending Sound - Artist Name",
    "tag": "trending",
    "social_post_link": "https://www.tiktok.com/@username/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"
  }
}

{
  "ok": true,
  "code": 200,
  "data": {
    "id": "audio_def456",
    "org_id": "org_xyz789",
    "name": "Original Audio - artistname",
    "tag": "instagram-audio",
    "social_post_link": "https://www.instagram.com/reel/ABC123xyz/",
    "social_audio_link": "https://www.instagram.com/reels/audio/1234567890/",
    "platform_type": "instagram",
    "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-15T10:30:00.000Z"
  }
}

{
  "ok": false,
  "code": 400,
  "message": "Invalid URL format. Must be a TikTok or Instagram URL"
}

{
  "ok": false,
  "code": 404,
  "message": "No posts found for this music"
}