API Documentation

async function identifyTracks(youtubeUrl) {
  try {
    // Start analysis
    const response = await fetch('https://trackid.dev/api/analyze', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ url: youtubeUrl })
    });
    
    if (!response.ok) throw new Error('Failed to start analysis');
    
    const { jobId } = await response.json();
    console.log('Job started:', jobId);
    
    // Poll for completion
    let job;
    do {
      await new Promise(resolve => setTimeout(resolve, 5000)); // Wait 5s
      
      const statusResponse = await fetch(`https://trackid.dev/api/job/${jobId}`);
      job = await statusResponse.json();
      
      console.log(`Progress: ${job.progress}% - ${job.currentStep}`);
    } while (job.status !== 'completed' && job.status !== 'failed');
    
    if (job.status === 'completed') {
      console.log('Found tracks:', job.tracks);
      return job.tracks;
    } else {
      throw new Error('Processing failed');
    }
    
  } catch (error) {
    console.error('Error:', error.message);
    throw error;
  }
}

// Usage
identifyTracks('https://youtu.be/LlIBWVxZLpc')
  .then(tracks => console.log('Success!', tracks))
  .catch(error => console.error('Failed:', error));

import requests
import time
import json

def identify_tracks(youtube_url):
    """Identify tracks in a YouTube video using TrackID.dev API"""
    
    # Start analysis
    response = requests.post('https://trackid.dev/api/analyze', 
                           json={'url': youtube_url})
    response.raise_for_status()
    
    job_id = response.json()['jobId']
    print(f"Job started: {job_id}")
    
    # Poll for completion
    while True:
        time.sleep(5)  # Wait 5 seconds
        
        status_response = requests.get(f'https://trackid.dev/api/job/{job_id}')
        status_response.raise_for_status()
        
        job = status_response.json()
        print(f"Progress: {job['progress']}% - {job['currentStep']}")
        
        if job['status'] == 'completed':
            print(f"Found {len(job['tracks'])} tracks")
            return job['tracks']
        elif job['status'] == 'failed':
            raise Exception(f"Processing failed: {job.get('error', 'Unknown error')}")

# Usage
try:
    tracks = identify_tracks('https://youtu.be/LlIBWVxZLpc')
    for track in tracks:
        if track.get('artist') and track.get('title'):
            print(f"{track['timestamp']}s - {track['artist']} - {track['title']}")
except Exception as e:
    print(f"Error: {e}")

# Start analysis
curl -X POST https://trackid.dev/api/analyze \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtu.be/LlIBWVxZLpc"}'

# Response: {"jobId": "job_123", "status": "queued", ...}

# Check status (replace job_123 with actual jobId)
curl https://trackid.dev/api/job/job_123

# Response: {"status": "completed", "tracks": [...], ...}