Get Project by ID

GET https://api.pictory.ai/pictoryapis/v2/projects/{projectid}

import requests
import time

def wait_for_render(project_id, api_key, timeout=300):
    """
    Poll project status until rendering is complete
    """
    url = f"https://api.pictory.ai/pictoryapis/v2/projects/{project_id}"
    headers = {"Authorization": api_key}

    start_time = time.time()

    while time.time() - start_time < timeout:
        response = requests.get(url, headers=headers)
        project = response.json()

        if project.get('step') == 'COMPLETE' or not project.get('inProgress'):
            print(f"Project rendering complete!")
            print(f"Video URL: {project.get('videoURL')}")
            return project

        print(f"Status: {project.get('step')}, In Progress: {project.get('inProgress')}")
        time.sleep(10)  # Check every 10 seconds

    raise TimeoutError("Project rendering timeout")

# Example usage
project = wait_for_render("YOUR_PROJECT_ID", "YOUR_API_KEY")

import requests
import os

def download_project_assets(project_id, api_key, output_dir="./downloads"):
    """
    Download video, audio, and subtitle files from a project
    """
    # Get project details
    url = f"https://api.pictory.ai/pictoryapis/v2/projects/{project_id}"
    headers = {"Authorization": api_key}

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

    # Create output directory
    os.makedirs(output_dir, exist_ok=True)

    # Download files
    assets = {
        'video': project.get('videoURL'),
        'audio': project.get('audioURL'),
        'srt': project.get('srtFile'),
        'vtt': project.get('vttFile'),
        'txt': project.get('txtFile')
    }

    for asset_type, url in assets.items():
        if url:
            filename = f"{project['projectName']}_{asset_type}.{asset_type}"
            filepath = os.path.join(output_dir, filename)

            # Download file
            file_response = requests.get(url)
            with open(filepath, 'wb') as f:
                f.write(file_response.content)

            print(f"Downloaded {asset_type}: {filepath}")

    print(f"All assets downloaded to {output_dir}")

# Example usage
download_project_assets("YOUR_PROJECT_ID", "YOUR_API_KEY")

async function analyzeProject(projectId, apiKey) {
  const response = await fetch(
    `https://api.pictory.ai/pictoryapis/v2/projects/${projectId}`,
    { headers: { 'Authorization': `${apiKey}` } }
  );

  const project = await response.json();

  const metadata = {
    name: project.projectName,
    source: project.source,
    schema: project.schemaVersion,
    aspectRatio: project.layout,
    duration: project.videoDuration,
    language: project.scriptLanguage,
    created: project.generatedDate,
    lastSaved: project.saveDate,
    voiceOver: project.voiceOverId,
    brand: project.brandId,
    template: project.smartTemplateId,
    sceneSettings: {
      maxLines: project.scriptTxtSceneSettings?.maxLines,
      autoHighlight: project.scriptTxtSceneSettings?.autoHighlightKeywords,
      autoVisuals: project.scriptTxtSceneSettings?.autoVisualSelection
    },
    assets: {
      video: project.videoURL,
      audio: project.audioURL,
      shareLink: project.shareVideoURL,
      subtitles: {
        srt: project.srtFile,
        vtt: project.vttFile,
        txt: project.txtFile
      }
    }
  };

  console.log('Project Analysis:', metadata);
  return metadata;
}

// Example usage
const analysis = await analyzeProject('YOUR_PROJECT_ID', 'YOUR_API_KEY');

def compare_projects(project_ids, api_key):
    """
    Compare configuration settings across multiple projects
    """
    url_template = "https://api.pictory.ai/pictoryapis/v2/projects/{}"
    headers = {"Authorization": api_key}

    projects = []
    for pid in project_ids:
        response = requests.get(url_template.format(pid), headers=headers)
        projects.append(response.json())

    # Compare key settings
    comparison = {
        'names': [p.get('projectName') for p in projects],
        'layouts': [p.get('layout') for p in projects],
        'schemas': [p.get('schemaVersion') for p in projects],
        'durations': [p.get('videoDuration') for p in projects],
        'audioSpeeds': [p.get('audioSpeed') for p in projects],
        'videoVolumes': [p.get('videoVolume') for p in projects],
        'maxLines': [p.get('scriptTxtSceneSettings', {}).get('maxLines') for p in projects]
    }

    print("Project Comparison:")
    for key, values in comparison.items():
        print(f"{key}: {values}")

    return comparison

# Example usage
comparison = compare_projects(
    ["project_id_1", "project_id_2", "project_id_3"],
    "YOUR_API_KEY"
)

async function getShareableLink(projectId, apiKey) {
  const response = await fetch(
    `https://api.pictory.ai/pictoryapis/v2/projects/${projectId}`,
    { headers: { 'Authorization': `${apiKey}` } }
  );

  const project = await response.json();

  if (project.shareVideoURL) {
    console.log(`Shareable link: ${project.shareVideoURL}`);
    console.log(`Project name: ${project.projectName}`);
    console.log(`Duration: ${project.videoDuration} seconds`);
    return project.shareVideoURL;
  } else {
    console.log('Shareable link not yet available');
    return null;
  }
}

// Example usage
const shareLink = await getShareableLink('YOUR_PROJECT_ID', 'YOUR_API_KEY');

import json
from datetime import datetime

def export_project_report(project_id, api_key, output_file="project_report.json"):
    """
    Export a detailed project report to JSON
    """
    url = f"https://api.pictory.ai/pictoryapis/v2/projects/{project_id}"
    headers = {"Authorization": api_key}

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

    # Create structured report
    report = {
        "reportGenerated": datetime.now().isoformat(),
        "projectId": project_id,
        "basicInfo": {
            "name": project.get('projectName'),
            "source": project.get('source'),
            "status": project.get('step'),
            "inProgress": project.get('inProgress'),
            "schemaVersion": project.get('schemaVersion')
        },
        "videoSettings": {
            "layout": project.get('layout'),
            "duration": project.get('videoDuration'),
            "volume": project.get('videoVolume')
        },
        "audioSettings": {
            "language": project.get('scriptLanguage'),
            "voiceOverId": project.get('voiceOverId'),
            "speed": project.get('audioSpeed')
        },
        "timestamps": {
            "created": project.get('generatedDate'),
            "lastSaved": project.get('saveDate')
        },
        "assets": {
            "video": project.get('videoURL'),
            "audio": project.get('audioURL'),
            "thumbnail": project.get('thumbnail'),
            "shareLink": project.get('shareVideoURL'),
            "subtitles": {
                "srt": project.get('srtFile'),
                "vtt": project.get('vttFile'),
                "txt": project.get('txtFile')
            }
        },
        "branding": {
            "brandId": project.get('brandId'),
            "templateId": project.get('smartTemplateId')
        }
    }

    # Export to JSON
    with open(output_file, 'w') as f:
        json.dump(report, f, indent=2)

    print(f"Project report exported to {output_file}")
    return report

# Example usage
report = export_project_report("YOUR_PROJECT_ID", "YOUR_API_KEY")