Apex Real Estate Video Generator

Video Types

| Type | ID | Duration | Aspect | Use Case | |------|-----|----------|--------|----------| | Property Showcase | property-showcase | 30s | 16:9 | Listing promotion | | Social Short | social-short | 9s | 9:16 | TikTok/Reels | | Market Stats | market-stats | 20s | 16:9 | Monthly reports | | Neighborhood Tour | neighborhood-tour | 45s | 16:9 | Area marketing | | Agent Intro | agent-intro | 15s | 9:16 | Personal branding | | Testimonial | testimonial | 20s | 16:9 | Social proof | | Just Listed | just-listed | 12s | 9:16 | New listing alert | | Just Sold | just-sold | 12s | 9:16 | Sales proof | | Open House | open-house | 15s | 9:16 | Event promotion | | Price Drop | price-drop | 10s | 9:16 | Price reduction |

Data Flow

[Listing URL] → [Firecrawl Extract] → [Property Data]
                                           ↓
[AI Script Generator] ← [Property Data + Video Type]
         ↓
[Remotion Composition] → [Rendered Video]
         ↓
[Optional: OpenAI TTS] → [Voiceover Audio]

API Usage

Generate Video

POST /api/video/generate
{
  listingUrl: "https://zillow.com/...",
  videoType: "property-showcase",
  voiceoverEnabled: true,
  branding: {
    agentName: "John Doe",
    brokerageName: "Apex Realty",
    logoUrl: "https://...",
    primaryColor: "#0dccf2"
  }
}

// Response
{
  success: true,
  videoId: "vid_abc123",
  status: "rendering",
  estimatedTime: 120 // seconds
}

Check Status

GET /api/video/status?id=vid_abc123

{
  status: "complete",
  videoUrl: "https://storage.../video.mp4",
  thumbnailUrl: "https://storage.../thumb.jpg",
  duration: 30,
  propertyData: { ... }
}

Template Details

See individual rules for each video type:

• Property Showcase: See rules/property-showcase.md
• Social Shorts: See rules/social-shorts.md
• Market Stats: See rules/market-stats.md
• Neighborhood Tour: See rules/neighborhood-tour.md
• Testimonial: See rules/testimonial-video.md

Branding System

All videos support custom branding:

• Agent name and photo
• Brokerage logo
• Primary accent color
• Contact information
• Social media handles
• Custom fonts (from Google Fonts)

Scene Structure

Property Showcase (30s)

1. Hook (0-3s): Stunning hero shot + price
2. Stats (3-7s): Beds, baths, sqft animation
3. Gallery (7-20s): Photo slideshow with Ken Burns
4. Features (20-25s): Key highlights list
5. CTA (25-30s): Contact info + logo

Social Short (9s)

1. Hook (0-2s): Eye-catching visual + text
2. Value (2-6s): 3 key stats animated
3. CTA (6-9s): Swipe up / Contact

Integration Points

• Firecrawl: Property data extraction
• Gemini AI: Script generation
• OpenAI TTS: Voiceover generation
• Remotion Lambda: Cloud rendering
• Supabase Storage: Video hosting
• Convex: Job tracking and history