Template Reference

Each template creates personalized videos from different data types. Some templates auto-fetch data from external sources (OpenAlex, Hardcover), while others require you to provide all data fields.

Template ID	Use Case	Auto-Fetch	Duration
`emeritus`	Academic research career celebration	✓ OpenAlex	~45s
`laureate`	Author literary career spotlight	✓ Hardcover	~50s
`rewind`	Year-in-review / Spotify Wrapped style	—	~60s
`pulse`	Business monthly/quarterly review	—	~40s
`handshake`	Client onboarding video	—	~35s

🎓

Emeritus

Celebrate academic careers by visualizing citations, collaborations, and global research impact.

AcademicAuto-fetch: OpenAlex~45 seconds

Data Fields

authorId

stringrequired

OpenAlex author ID (e.g., "A5001825849"). When provided, all research data is fetched automatically from the OpenAlex API.

person_name

string

Override the author's display name. If omitted, uses the name from OpenAlex.

institutionOverride

string

Override the primary institution. If omitted, uses the most recent affiliation from OpenAlex.

Auto-Fetched Data

When you provide an authorId, Significant Figures automatically fetches from OpenAlex:

Total citations and h-index
Publication count and timeline
Top collaborators and institutions
Geographic collaboration map (cities, countries)
Citation growth over time
Most cited publications

Example Request

curl

curl -X POST https://app.sigfigsstudio.com/api/render \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sf_live_YOUR_KEY" \
  -d '{
    "templateId": "emeritus",
    "data": {
      "authorId": "A5001825849"
    },
    "brand": {
      "accentColor": "#8b5cf6"
    },
    "audio": {
      "includeVoiceover": true,
      "voiceId": "en-GB-RyanNeural"
    }
  }'

Output

A 45-second video featuring: hero title card, citation metrics, collaboration map, publication timeline, top co-authors, and closing card.

📚

Laureate

Celebrate an author's literary career with book covers, ratings, publication timeline, and genre breakdown.

LiteraryAuto-fetch: Hardcover~50 seconds

Data Fields

hardcover_id

string

Hardcover author ID. When provided, book data is fetched automatically from Hardcover API.

person_name

stringrequired

Author's name.

books

array

Manual book data (only if not using hardcover_id). Array of objects with: title, year,rating, genre.

totalBooks

number

Total books published. Auto-calculated if books array is provided.

avgRating

number

Average rating (0-5). Auto-calculated from book ratings if not provided.

Example Request

curl

curl -X POST https://app.sigfigsstudio.com/api/render \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sf_live_YOUR_KEY" \
  -d '{
    "templateId": "laureate",
    "data": {
      "hardcover_id": "12345",
      "person_name": "Margaret Atwood"
    }
  }'

Output

A 50-second video with: author introduction, book cover montage, genre breakdown chart, publication timeline, rating stats, and closing message.

🎉

Rewind

Year-in-review style video — Spotify Wrapped for any product. Workouts, purchases, usage stats, achievements.

WrappedManual data~60 seconds

Data Fields

person_name

stringrequired

User's name.

year

number

Year being recapped (e.g., 2026). Defaults to current year.

totalWorkouts

numberrequired

Total workout count or activity count.

totalMinutes

number

Total minutes of activity.

percentile

number

Percentile rank vs. other users (0-100).

radarData

array

Array of category scores for radar chart. Example:[{category: "Cardio", score: 85}, ...]

achievements

array

Achievements unlocked. Array of strings or objects with name and icon.

topDay

string

Best single day. Example: "March 14".

Example Request

curl

curl -X POST https://app.sigfigsstudio.com/api/render \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sf_live_YOUR_KEY" \
  -d '{
    "templateId": "rewind",
    "data": {
      "person_name": "Alex Chen",
      "year": 2026,
      "totalWorkouts": 156,
      "totalMinutes": 8940,
      "percentile": 92,
      "radarData": [
        {"category": "Cardio", "score": 85},
        {"category": "Strength", "score": 78},
        {"category": "Flexibility", "score": 65},
        {"category": "Endurance", "score": 90}
      ],
      "topDay": "June 15"
    }
  }'

Output

A 60-second video with: year intro, total stats reveal, percentile ranking, radar chart animation, best day highlight, achievements, and closing card.

📊

Pulse

Business monthly or quarterly review videos. Perfect for recurring touchpoints with customers or team members.

BusinessManual data~40 seconds

Data Fields

person_name

stringrequired

Recipient name.

period

stringrequired

Period label. Example: "March 2026" or "Q1 2026".

keyStats

arrayrequired

Key metrics to highlight. Array of objects:[{label: "Revenue", value: "$45K", change: "+12%"}, ...]

categories

array

Category breakdown for charts. Example:[{name: "Product A", value: 3500}, ...]

highlights

array

Text highlights or milestones. Array of strings.

Example Request

curl

curl -X POST https://app.sigfigsstudio.com/api/render \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sf_live_YOUR_KEY" \
  -d '{
    "templateId": "pulse",
    "data": {
      "person_name": "Sarah Johnson",
      "period": "March 2026",
      "keyStats": [
        {"label": "Revenue", "value": "$45,200", "change": "+12%"},
        {"label": "New Customers", "value": "37", "change": "+8%"},
        {"label": "Retention Rate", "value": "94%", "change": "+2%"}
      ],
      "categories": [
        {"name": "Enterprise", "value": 28000},
        {"name": "SMB", "value": 12000},
        {"name": "Startup", "value": 5200}
      ]
    }
  }'

Output

A 40-second video with: period intro, key stats reveal, category breakdown chart, highlights, and forward-looking message.

👋

Handshake

Personalized client onboarding video showcasing company milestones, team members, and key achievements.

OnboardingManual data~35 seconds

Data Fields

company_name

stringrequired

Client company name.

person_name

string

Key contact name at the client company.

industry

string

Client industry (e.g., "Healthcare", "Finance").

milestones

array

Company timeline milestones. Array of objects:[{year: 2010, event: "Founded"}, ...]

companyStats

array

Key company statistics. Example:[{label: "Employees", value: "500+"}, ...]

logoUrl

string

Client company logo URL (will be shown alongside your brand logo).

Example Request

curl

curl -X POST https://app.sigfigsstudio.com/api/render \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sf_live_YOUR_KEY" \
  -d '{
    "templateId": "handshake",
    "data": {
      "company_name": "Meridian Health",
      "person_name": "Dr. Sarah Chen",
      "industry": "Healthcare",
      "milestones": [
        {"year": 2015, "event": "Founded"},
        {"year": 2018, "event": "First clinic opened"},
        {"year": 2023, "event": "20,000 patients served"}
      ],
      "companyStats": [
        {"label": "Clinics", "value": "8"},
        {"label": "Staff", "value": "120+"}
      ]
    }
  }'

Output

A 35-second video with: welcome message, company timeline, key stats, personalized closing with contact name.

Best Practices

Use Auto-Fetch When Available

emeritus and laureate can fetch data automatically. This reduces API payload size and ensures data accuracy.

Validate Data Before Sending

Missing required fields will cause a 400 Bad Request error. Check the data schema for each template before making a render request.

Batch Renders Work with All Templates

Use POST /api/render/batch with any template. Provide CSV-style headers and rows arrays.

Preview Templates Before Integrating

Visit the templates page to see example videos and understand what each template produces.

Ready to create videos?

Start with the quickstart guide or dive into the full API reference.

Quickstart Guide API Reference