List Projects

GET https://api.pictory.ai/pictoryapis/v2/projects

import requests

url = "https://api.pictory.ai/pictoryapis/v2/projects"
headers = {"Authorization": "YOUR_API_KEY"}

response = requests.get(url, headers=headers)
data = response.json()

print(f"Total projects: {len(data['items'])}")

for project in data['items']:
    print(f"{project['name']} ({project['source']})")

def get_all_projects(api_key):
    """
    Retrieve all projects using pagination
    """
    all_projects = []
    page_key = None
    base_url = "https://api.pictory.ai/pictoryapis/v2/projects"
    headers = {"Authorization": api_key}

    while True:
        # Build URL with page key if available
        url = f"{base_url}?pagekey={page_key}" if page_key else base_url

        response = requests.get(url, headers=headers)
        data = response.json()

        # Add projects from this page
        all_projects.extend(data['items'])

        # Check if there are more pages
        page_key = data.get('pageKey')
        if not page_key:
            break

    return all_projects

# Get all projects
projects = get_all_projects("YOUR_API_KEY")
print(f"Retrieved {len(projects)} total projects")

const getProjectsBySource = async (sourceType) => {
  const response = await fetch(
    'https://api.pictory.ai/pictoryapis/v2/projects',
    {
      headers: { 'Authorization': 'YOUR_API_KEY' }
    }
  );

  const data = await response.json();

  // Filter by source type
  const filtered = data.items.filter(p => p.source === sourceType);

  console.log(`Found ${filtered.length} ${sourceType} projects`);
  return filtered;
};

// Get only script-based projects
const scriptProjects = await getProjectsBySource('script');

// Get only transcription-based projects
const transcribeProjects = await getProjectsBySource('transcribe');

// Get only URL-based projects
const urlProjects = await getProjectsBySource('url');

def get_folder_projects(folder_id, api_key):
    """
    Get all projects within a specific folder
    """
    url = f"https://api.pictory.ai/pictoryapis/v2/projects?folder={folder_id}"
    headers = {"Authorization": api_key}

    response = requests.get(url, headers=headers)
    data = response.json()

    return data['items']

# Example usage
folder_projects = get_folder_projects("your-folder-id", "YOUR_API_KEY")
print(f"Folder contains {len(folder_projects)} projects")

from datetime import datetime, timedelta
import requests

def get_recent_projects(days=7, api_key="YOUR_API_KEY"):
    """
    Get projects modified in the last N days
    """
    url = "https://api.pictory.ai/pictoryapis/v2/projects"
    headers = {"Authorization": api_key}

    response = requests.get(url, headers=headers)
    data = response.json()

    # Calculate cutoff date
    cutoff = datetime.now() - timedelta(days=days)

    # Filter by saved date
    recent = [
        p for p in data['items']
        if datetime.fromisoformat(p['savedDate'].replace('Z', '+00:00')) > cutoff
    ]

    return recent

# Get projects from last 7 days
recent_projects = get_recent_projects(days=7)
print(f"Found {len(recent_projects)} projects modified in last 7 days")

for project in recent_projects:
    print(f"- {project['name']} (saved: {project['savedDate']})")

const organizeBySchemaVersion = async () => {
  const response = await fetch(
    'https://api.pictory.ai/pictoryapis/v2/projects',
    { headers: { 'Authorization': 'YOUR_API_KEY' } }
  );

  const data = await response.json();

  // Group by schema version
  const grouped = data.items.reduce((acc, project) => {
    const version = project.schemaVersion || 'legacy';
    if (!acc[version]) acc[version] = [];
    acc[version].push(project);
    return acc;
  }, {});

  // Display statistics
  Object.entries(grouped).forEach(([version, projects]) => {
    console.log(`${version}: ${projects.length} projects`);
  });

  return grouped;
};

// Organize projects
const projectsByVersion = await organizeBySchemaVersion();

import json
import csv
import requests

def export_projects_json(api_key, filename="projects.json"):
    """
    Export all projects to JSON file
    """
    url = "https://api.pictory.ai/pictoryapis/v2/projects"
    headers = {"Authorization": api_key}

    response = requests.get(url, headers=headers)
    data = response.json()

    with open(filename, 'w') as f:
        json.dump(data['items'], f, indent=2)

    print(f"Exported {len(data['items'])} projects to {filename}")

def export_projects_csv(api_key, filename="projects.csv"):
    """
    Export all projects to CSV file
    """
    url = "https://api.pictory.ai/pictoryapis/v2/projects"
    headers = {"Authorization": api_key}

    response = requests.get(url, headers=headers)
    data = response.json()

    if not data['items']:
        print("No projects to export")
        return

    # Get fieldnames from first project
    fieldnames = ['id', 'name', 'source', 'savedDate', 'aspectRatio', 'schemaVersion', 'type']

    with open(filename, 'w', newline='') as f:
        writer = csv.DictWriter(f, fieldnames=fieldnames, extrasaction='ignore')
        writer.writeheader()
        writer.writerows(data['items'])

    print(f"Exported {len(data['items'])} projects to {filename}")

# Export to both formats
export_projects_json("YOUR_API_KEY")
export_projects_csv("YOUR_API_KEY")

def search_projects_by_name(search_term, api_key):
    """
    Search for projects matching a name pattern
    """
    url = "https://api.pictory.ai/pictoryapis/v2/projects"
    headers = {"Authorization": api_key}

    response = requests.get(url, headers=headers)
    data = response.json()

    # Case-insensitive search
    matches = [
        p for p in data['items']
        if search_term.lower() in p['name'].lower()
    ]

    return matches

# Example usage
results = search_projects_by_name("hello", "YOUR_API_KEY")
print(f"Found {len(results)} projects containing 'hello':")
for project in results:
    print(f"- {project['name']} (ID: {project['id']})")