Get Music Purposes

GET https://api.pictory.ai/pictoryapis/v1/music/purposes

purposes = requests.get(
    "https://api.pictory.ai/pictoryapis/v1/music/purposes",
    headers={"Authorization": "YOUR_API_KEY"}
).json()

# Use purposes to populate UI dropdown
purpose_options = [{"label": purpose, "value": purpose} for purpose in purposes]

const response = await fetch('https://api.pictory.ai/pictoryapis/v1/music/purposes', {
  headers: { 'Authorization': 'YOUR_API_KEY' }
});
const purposes = await response.json();

// Categorize by type
const mediaGenres = purposes.filter(p =>
  ['Action', 'Adventure', 'Comedy', 'Drama', 'Fantasy', 'Horror', 'Thriller', 'Sci-Fi'].includes(p)
);

const businessPurposes = purposes.filter(p =>
  p.includes('Corporate') || p.includes('Business') || p.includes('Branding') ||
  p.includes('Real Estate') || p.includes('Technology')
);

const timePerods = purposes.filter(p =>
  ['50s', '60s', '70s', '80s', 'Retro', 'Futuristic', 'Historical / Period'].includes(p)
);

const videoPurposes = purposes.filter(p =>
  p.includes('Animation') || p.includes('Trailer') || p.includes('Time Lapse') ||
  p.includes('Slow-Mo') || p.includes('Explainer')
);

const eventPurposes = purposes.filter(p =>
  ['Wedding', 'Christmas', 'Circus / Carnival', 'Game Show'].includes(p)
);

const wellnessPurposes = purposes.filter(p =>
  p.includes('Yoga') || p.includes('Meditation') || p.includes('Relaxation') ||
  p.includes('Aerobics') || p.includes('Fitness')
);

valid_purposes = requests.get(
    "https://api.pictory.ai/pictoryapis/v1/music/purposes",
    headers={"Authorization": "YOUR_API_KEY"}
).json()

user_purpose = "Corporate / Business"
if user_purpose in valid_purposes:
    # Proceed with music search using this purpose
    print(f"Searching for {user_purpose} music...")
else:
    print("Invalid purpose selected")

import requests

purposes = requests.get(
    "https://api.pictory.ai/pictoryapis/v1/music/purposes",
    headers={"Authorization": "YOUR_API_KEY"}
).json()

# Organize by category
categories = {
    "Film & TV": [p for p in purposes if any(x in p for x in ['TV Theme', 'Action', 'Adventure', 'Comedy', 'Drama', 'Fantasy', 'Horror', 'Thriller', 'Sci-Fi', 'Western', 'Detective', 'Spy'])],

    "Business & Corporate": [p for p in purposes if any(x in p for x in ['Corporate', 'Business', 'Branding', 'Identity', 'Technology', 'Real Estate', 'Educational', 'News'])],

    "Video Production": [p for p in purposes if any(x in p for x in ['Animation', 'Explainer', 'Trailer', 'Promo', 'Time Lapse', 'Slow-Mo'])],

    "Events & Occasions": [p for p in purposes if any(x in p for x in ['Wedding', 'Christmas', 'Circus', 'Carnival', 'Game Show', 'Shopping'])],

    "Time Periods": [p for p in purposes if p in ['50s', '60s', '70s', '80s', 'Retro', 'Historical / Period', 'Futuristic']],

    "Wellness & Lifestyle": [p for p in purposes if any(x in p for x in ['Yoga', 'Meditation', 'Relaxation', 'Aerobics', 'Fitness', 'Fashion', 'Beauty', 'Luxury'])],

    "Moods & Emotions": [p for p in purposes if any(x in p for x in ['Heroic', 'Success', 'Victory', 'Failure', 'Defeat', 'Adrenaline', 'Romantic', 'Lullaby'])],

    "Nature & Places": [p for p in purposes if any(x in p for x in ['Nature', 'Beauty', 'Landscape', 'Panorama', 'Space', 'Cosmos', 'Tropical', 'Swampy', 'Outback'])],

    "Cultural & Regional": [p for p in purposes if any(x in p for x in ['Bollywood', 'Western', 'Cowboy', 'Religious', 'Church', 'Tribal', 'Exotic'])],

    "Special Applications": [p for p in purposes if any(x in p for x in ['On-Hold', 'Elevator', 'Nightclub', 'Road Trip', 'Surfing', 'Chase Sequence'])]
}

for category, purpose_list in categories.items():
    print(f"\n{category}:")
    for purpose in sorted(purpose_list):
        print(f"  - {purpose}")

async function recommendPurposes(videoKeywords) {
  const response = await fetch(
    'https://api.pictory.ai/pictoryapis/v1/music/purposes',
    { headers: { 'Authorization': 'YOUR_API_KEY' } }
  );
  const allPurposes = await response.json();

  // Map keywords to relevant purposes
  const keywordMappings = {
    'office': ['Corporate / Business', 'Technology', 'Educational'],
    'wedding': ['Wedding', 'Romantic Comedy', 'Fashion / Beauty'],
    'product': ['Branding / Identity', 'Corporate / Business', 'Shopping'],
    'fitness': ['Aerobics / Fitness', 'Sports', 'Yoga / Relaxation'],
    'travel': ['Road Trip', 'Adventure', 'Landscape / Panorama'],
    'children': ['Children / Preschool', 'Fairytale', 'Animation / Explainer'],
    'tech': ['Technology', 'Futuristic', 'Corporate / Business'],
    'luxury': ['Luxury', 'Fashion / Beauty', 'Regal / Royal'],
    'nature': ['Nature / Beauty', 'Landscape / Panorama', 'Time Lapse']
  };

  const recommendations = new Set();

  videoKeywords.forEach(keyword => {
    const mapped = keywordMappings[keyword.toLowerCase()];
    if (mapped) {
      mapped.forEach(purpose => {
        if (allPurposes.includes(purpose)) {
          recommendations.add(purpose);
        }
      });
    }
  });

  return Array.from(recommendations);
}

// Example usage
const suggestions = await recommendPurposes(['office', 'tech', 'product']);
console.log('Recommended purposes:', suggestions);
// Output: ['Corporate / Business', 'Technology', 'Branding / Identity', ...]

def get_time_period_purposes(api_key):
    """
    Extract time period-specific purposes for historical or retro content
    """
    headers = {"Authorization": api_key}

    all_purposes = requests.get(
        "https://api.pictory.ai/pictoryapis/v1/music/purposes",
        headers=headers
    ).json()

    time_periods = {
        "Classic Eras": ['50s', '60s', '70s', '80s'],
        "Historical": ['Historical / Period', 'Western / Cowboy'],
        "Retro & Vintage": ['Retro', 'Bollywood'],
        "Future": ['Futuristic', 'Sci-Fi', 'Space / Cosmos']
    }

    filtered_periods = {}
    for category, keywords in time_periods.items():
        filtered_periods[category] = [
            p for p in all_purposes
            if p in keywords
        ]

    return filtered_periods

# Example usage
periods = get_time_period_purposes("YOUR_API_KEY")
for category, purposes in periods.items():
    print(f"{category}: {', '.join(purposes)}")