Search Music Tracks

POST https://api.pictory.ai/pictoryapis/v1/music/search

import requests

url = "https://api.pictory.ai/pictoryapis/v1/music/search"
headers = {
    "Authorization": "YOUR_API_KEY",
    "Content-Type": "application/json"
}

# Search for "corporate" themed music
payload = {
    "page": 1,
    "pageSize": 20,
    "query": "corporate"
}

response = requests.post(url, json=payload, headers=headers)
tracks = response.json()

print(f"Found {tracks['totalItems']} corporate tracks")

const searchTracks = async (filters) => {
  const response = await fetch(
    'https://api.pictory.ai/pictoryapis/v1/music/search',
    {
      method: 'POST',
      headers: {
        'Authorization': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        page: 1,
        pageSize: 20,
        genre: ['Indie Rock', 'Pop Rock'],
        mood: ['Energetic / Lively', 'Happy / Bright'],
        instrument: ['Guitar - Electric', 'Drum Kit'],
        purpose: ['Corporate / Business', 'Branding / Identity'],
        minDuration: 60,
        maxDuration: 180
      })
    }
  );

  const data = await response.json();
  return data.items;
};

// Get energetic rock tracks suitable for corporate use
const tracks = await searchTracks();
console.log(`Found ${tracks.length} matching tracks`);

# Find upbeat music WITHOUT specific moods or instruments
payload = {
    "page": 1,
    "pageSize": 20,
    "mood": ["Upbeat / Cheerful", "Energetic / Lively"],
    "notMood": ["Dark / Brooding", "Sad / Melancholic"],
    "notInstrument": ["Violin / Viola", "Cello"],
    "purpose": ["Corporate / Business"]
}

response = requests.post(
    "https://api.pictory.ai/pictoryapis/v1/music/search",
    json=payload,
    headers={"Authorization": "YOUR_API_KEY", "Content-Type": "application/json"}
)

tracks = response.json()
print(f"Found {tracks['totalItems']} upbeat corporate tracks without strings")

def find_tracks_by_duration(min_sec, max_sec, purpose=None):
    """
    Find music tracks within a specific duration range
    """
    payload = {
        "page": 1,
        "pageSize": 50,
        "minDuration": min_sec,
        "maxDuration": max_sec
    }

    if purpose:
        payload["purpose"] = [purpose]

    response = requests.post(
        "https://api.pictory.ai/pictoryapis/v1/music/search",
        json=payload,
        headers={
            "Authorization": "YOUR_API_KEY",
            "Content-Type": "application/json"
        }
    )

    return response.json()

# Find short corporate tracks (30-60 seconds)
short_tracks = find_tracks_by_duration(30, 60, "Corporate / Business")
print(f"Found {short_tracks['totalItems']} tracks between 30-60 seconds")

# Find longer background tracks (3-5 minutes)
long_tracks = find_tracks_by_duration(180, 300)
print(f"Found {long_tracks['totalItems']} tracks between 3-5 minutes")

async function getAllTracks(searchCriteria) {
  let allTracks = [];
  let currentPage = 1;
  let totalPages = 1;

  while (currentPage <= totalPages) {
    const response = await fetch(
      'https://api.pictory.ai/pictoryapis/v1/music/search',
      {
        method: 'POST',
        headers: {
          'Authorization': 'YOUR_API_KEY',
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({
          ...searchCriteria,
          page: currentPage,
          pageSize: 100 // Maximum page size
        })
      }
    );

    const data = await response.json();
    allTracks = allTracks.concat(data.items);
    totalPages = data.totalPages;
    currentPage++;

    console.log(`Retrieved page ${currentPage - 1} of ${totalPages}`);
  }

  return allTracks;
}

// Get all piano tracks
const allPianoTracks = await getAllTracks({
  instrument: ['Piano']
});
console.log(`Total piano tracks: ${allPianoTracks.length}`);

# Get latest upbeat corporate tracks
payload = {
    "page": 1,
    "pageSize": 20,
    "sort": "latest",
    "mood": ["Upbeat / Cheerful", "Energetic / Lively"],
    "purpose": ["Corporate / Business", "Branding / Identity"]
}

response = requests.post(
    "https://api.pictory.ai/pictoryapis/v1/music/search",
    json=payload,
    headers={
        "Authorization": "YOUR_API_KEY",
        "Content-Type": "application/json"
    }
)

latest_tracks = response.json()

# Get featured tracks for variety
payload["sort"] = "featured"
response = requests.post(
    "https://api.pictory.ai/pictoryapis/v1/music/search",
    json=payload,
    headers={
        "Authorization": "YOUR_API_KEY",
        "Content-Type": "application/json"
    }
)

featured_tracks = response.json()

def recommend_music_for_video(video_keywords, video_duration, video_type):
    """
    Recommend music based on video characteristics
    """
    # Map video type to purpose
    purpose_mapping = {
        "corporate": ["Corporate / Business", "Branding / Identity"],
        "wedding": ["Wedding", "Romantic Comedy"],
        "travel": ["Adventure", "Road Trip", "Nature / Beauty"],
        "tech": ["Technology", "Futuristic"],
        "kids": ["Children / Preschool", "Educational"]
    }

    # Determine mood from keywords
    mood_mapping = {
        "happy": ["Happy / Bright", "Joyful", "Upbeat / Cheerful"],
        "calm": ["Calm / Serene", "Gentle / Soft"],
        "energetic": ["Energetic / Lively", "Exciting / Rousing"],
        "dramatic": ["Dramatic", "Intense / Hard"]
    }

    purposes = purpose_mapping.get(video_type, [])
    moods = []
    for keyword in video_keywords:
        if keyword in mood_mapping:
            moods.extend(mood_mapping[keyword])

    # Search with calculated criteria
    payload = {
        "page": 1,
        "pageSize": 20,
        "sort": "featured",
        "purpose": purposes,
        "mood": moods,
        "minDuration": int(video_duration * 0.8),  # At least 80% of video duration
        "maxDuration": int(video_duration * 1.2)   # At most 120% of video duration
    }

    response = requests.post(
        "https://api.pictory.ai/pictoryapis/v1/music/search",
        json=payload,
        headers={
            "Authorization": "YOUR_API_KEY",
            "Content-Type": "application/json"
        }
    )

    return response.json()

# Example: Find music for 90-second corporate video with happy theme
recommendations = recommend_music_for_video(
    video_keywords=["happy", "energetic"],
    video_duration=90,
    video_type="corporate"
)

print(f"Recommended {len(recommendations['items'])} tracks")
for track in recommendations['items'][:5]:
    print(f"- {track['title']} ({track['duration']}s)")

async function exploreGenreGroup(genreGroup) {
  // First, search by genre group
  const groupResponse = await fetch(
    'https://api.pictory.ai/pictoryapis/v1/music/search',
    {
      method: 'POST',
      headers: {
        'Authorization': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        page: 1,
        pageSize: 20,
        genreGroup: [genreGroup],
        sort: 'featured'
      })
    }
  );

  const groupTracks = await groupResponse.json();

  // Analyze genres within this group
  const genresFound = new Set();
  groupTracks.items.forEach(track => {
    track.genres.forEach(genre => genresFound.add(genre));
  });

  console.log(`Genre Group: ${genreGroup}`);
  console.log(`Total tracks: ${groupTracks.totalItems}`);
  console.log(`Specific genres found: ${Array.from(genresFound).join(', ')}`);

  return {
    totalTracks: groupTracks.totalItems,
    genres: Array.from(genresFound),
    sampleTracks: groupTracks.items
  };
}

// Explore Electronic music
const electronicMusic = await exploreGenreGroup('Electronic');