API Documentation

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

curl https://api.repurposeapi.com/v1/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "transcript_text": "In this episode, we discuss the future of artificial intelligence and machine learning. We explore how AI is revolutionizing healthcare, finance, and transportation. Our guest emphasizes the importance of ethical AI development and transparency."
  }'

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

curl https://api.repurposeapi.com/v1/jobs/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "job": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "output_data": {
      "short": "This episode explores AI's impact on healthcare, finance, and transportation, emphasizing ethical development.",
      "medium": "A comprehensive discussion on artificial intelligence and machine learning...",
      "long": "An in-depth exploration of how artificial intelligence is transforming..."
    }
  }
}

{
  "status": "ok",
  "timestamp": "2025-12-15T10:30:00.000Z",
  "service": "api"
}

{
  "upload_url": "https://<account>.r2.cloudflarestorage.com/<bucket>/uploads/...?X-Amz-Signature=...",
  "download_url": "https://<account>.r2.cloudflarestorage.com/<bucket>/uploads/...?X-Amz-Signature=...",
  "file_key": "uploads/user-id/1234567890-abc123.mp3"
}

{
  "live_jobs_created": 5,
  "live_jobs_completed": 4,
  "live_minutes_used": 18.5,
  "credit_balance_cents": 305,
  "credit_balance_usd": "3.05",
  "subscription_tier": "builder",
  "subscription_status": "active",
  "pending_plan": null,
  "billing_period_end": "2026-02-28"
}

{
  "jobs": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "completed",
      "job_type": "transcribe",
      "created_at": "2025-12-15T10:00:00.000Z"
    }
  ]
}

{
  "job": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "job_type": "podcast_to_blog",
    "input_url": "https://<account>.r2.cloudflarestorage.com/<bucket>/uploads/...",
    "output_data": { "...": "workflow result" },
    "error_message": null,
    "metadata": { "tone": "professional" },
    "created_at": "2025-12-15T10:00:00.000Z",
    "updated_at": "2025-12-15T10:00:30.000Z",
    "usage": {
      "endpoint": "/v1/workflows/podcast-to-blog",
      "billable_unit": "audio_minute",
      "quantity": 32.5,
      "rate_cents": 6.0,
      "charge_cents": 195.0,
      "charge_usd": "1.95",
      "credit_balance_cents": 305.0,
      "credit_balance_usd": "3.05"
    }
  }
}

{
  "transcript": {
    "text": "Full transcript text...",
    "segments": [{ "start": 0.0, "end": 5.2, "text": "First segment..." }],
    "language": "en",
    "duration": 1800.5,
    "source_job_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

{
  "transcript": "Full transcription text...",
  "segments": [
    { "start": 0.0, "end": 5.2, "text": "Hello and welcome to the podcast." }
  ],
  "language": "en",
  "duration": 3600.5
}

{
  "chapters": [
    { "title": "Introduction", "description": "Overview of the episode topics" },
    { "title": "Main Discussion", "description": "Deep dive into the core subject" }
  ]
}

{
  "short": "One to two sentence summary...",
  "medium": "One paragraph summary...",
  "long": "Two to three paragraph detailed summary..."
}

{
  "captions": {
    "twitter": {
      "text": "Just learned the #1 mistake founders make when scaling...",
      "hashtags": ["#startup", "#founders", "#scaleup"],
      "char_count": 142
    },
    "linkedin": {
      "text": "In today's episode, we explore the critical mistakes...",
      "hashtags": ["#leadership", "#business", "#entrepreneurship"],
      "word_count": 180
    },
    "instagram": {
      "caption": "🚀 What if I told you most founders fail at scaling for ONE reason?",
      "hashtags": ["#podcast", "#business", "#motivation", "#startup"]
    },
    "tiktok": {
      "caption": "Wait for the plot twist at 0:45 👀",
      "hashtags": ["#podcast", "#viral", "#fyp", "#business"]
    }
  }
}

{
  "cleaned_text": "In this episode, we discuss the three pillars of...",
  "changes": {
    "timestamps_removed": 5,
    "repetitions_fixed": 12,
    "music_artifacts_removed": 3,
    "filler_words_removed": 47
  },
  "original_length": 1520,
  "cleaned_length": 1345
}

{
  "clips": [
    {
      "rank": 1,
      "start": 145.2,
      "end": 165.8,
      "duration": 20.6,
      "text": "This is the most important insight...",
      "score": 0.92,
      "reason": "High engagement moment discussing key insight with emotional impact"
    }
  ]
}

{
  "transcript": "Full transcription...",
  "summary": "This podcast discusses strategies for scaling...",
  "chapters": [
    { "title": "Introduction", "start_time": "00:00", "summary": "Overview of scaling challenges" },
    { "title": "Hiring Strategy", "start_time": "05:30", "summary": "How to build the right team" }
  ],
  "blog_draft": "# How to Scale Your Startup\n\n## Introduction\n\n...",
  "language": "en",
  "duration": 3600.5
}

{
  "transcript": "Full transcription...",
  "segments": [{ "start": 0.0, "end": 5.2, "text": "First segment..." }],
  "duration": 1800.5,
  "language": "en",
  "clips": [
    {
      "rank": 1, "start": 30.0, "end": 52.0, "duration": 22.0,
      "text": "The clip transcript text...",
      "score": 0.92,
      "reason": "Strong hook with a quotable takeaway",
      "social": {
        "hook": "This changes everything about AI",
        "twitter": { "text": "...", "hashtags": ["AI", "Podcasting"] },
        "linkedin": { "text": "...", "hashtags": ["AIInsights"] },
        "instagram": { "caption": "...", "hashtags": ["AI", "PodcastClips"] },
        "tiktok": { "caption": "...", "hashtags": ["ai", "fyp"] }
      }
    }
  ],
  "processing_time": {
    "transcription": 45.2, "clip_detection": 8.1, "enrichment": 5.3, "total": 58.6
  }
}

{
  "transcript": "Full transcript...",
  "thread": [
    { "tweet_number": 1, "text": "1/ Hook tweet...", "char_count": 142 }
  ],
  "thread_count": 7,
  "topic": "One-line topic summary",
  "processing_time": { "transcription": 12.5, "thread_generation": 3.2, "total": 15.7 }
}

{
  "transcript": "Full transcript...",
  "summary": "Meeting summary...",
  "action_items": [
    { "id": 1, "action": "Finalize spec", "owner": "Sarah", "priority": "high", "deadline_suggestion": "by Friday" }
  ],
  "key_decisions": ["Launch date set for March 15"],
  "main_topics": ["Roadmap", "Testing"],
  "processing_time": { "transcription": 18.3, "extraction": 4.1, "total": 22.4 }
}

{
  "transcript": "Full transcript...",
  "hooks": [
    {
      "text": "Most people are productive for only 3 hours a day.",
      "type": "statistic",
      "source_timestamp": 45.0,
      "why_it_works": "Specific number creates curiosity"
    }
  ],
  "processing_time": { "transcription": 10.2, "hook_extraction": 3.8, "total": 14.0 }
}

{
  "transcript": "Full transcript...",
  "newsletter": {
    "subject_line": "3 lessons from building in public",
    "preview_text": "What a year of sharing everything taught me",
    "sections": [
      { "heading": "The Uncomfortable Truth", "body": "Section content..." }
    ],
    "call_to_action": "Hit reply and tell me..."
  },
  "summary": { "short": "...", "medium": "...", "long": "..." },
  "processing_time": { "transcription": 15.0, "summary": 3.5, "newsletter_generation": 5.2, "total": 23.7 }
}

{
  "error": {
    "code": "invalid_file_format",
    "message": "Unsupported format. Use MP3, MP4, WAV, M4A, or FLAC."
  }
}

// 1. Get presigned upload URL
const uploadRes = await fetch('https://api.repurposeapi.com/v1/uploads/presigned', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    filename: 'podcast.mp3',
    content_type: 'audio/mpeg'
  })
})
const { upload_url, download_url } = await uploadRes.json()

// 2. Upload file to storage
await fetch(upload_url, {
  method: 'PUT',
  headers: { 'Content-Type': 'audio/mpeg' },
  body: audioFile
})

// 3. Create podcast-to-blog job
const jobRes = await fetch('https://api.repurposeapi.com/v1/workflows/podcast-to-blog', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    file_url: download_url,
    title: 'How to Scale Your Startup',
    tone: 'professional'
  })
})
const { job } = await jobRes.json()

// 4. Poll for completion
let completed = false
while (!completed) {
  await new Promise(resolve => setTimeout(resolve, 3000))

  const statusRes = await fetch(`https://api.repurposeapi.com/v1/jobs/${job.id}`, {
    headers: { 'Authorization': `Bearer ${token}` }
  })
  const { job: updatedJob } = await statusRes.json()

  if (updatedJob.status === 'completed') {
    console.log('Transcript:', updatedJob.output_data.transcript)
    console.log('Blog Draft:', updatedJob.output_data.blog_draft)
    completed = true
  } else if (updatedJob.status === 'failed') {
    throw new Error(updatedJob.error_message)
  }
}