Podhoc API Documentation

curl -X POST https://api-ext.podhoc.com/v1/podcasts \
  -H "X-Api-Key: phk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://example.com/article"],
    "language": "en-US",
    "target_duration_minutes": 10,
    "style": "deep_dive"
  }'

{
  "success": true,
  "data": {
    "podcast_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "processing",
    "estimated_duration_minutes": 10,
    "credits_charged": 38
  },
  "meta": {
    "request_id": "f1e2d3c4-b5a6-7890-abcd-ef1234567890",
    "credits_charged": 38,
    "credit_balance": 462
  }
}

curl https://api-ext.podhoc.com/v1/podcasts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/status \
  -H "X-Api-Key: phk_test_..."

{
  "success": true,
  "data": {
    "podcast_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "completed",
    "progress": 100,
    "started_at": "2026-03-27T10:00:00+00:00"
  }
}

curl https://api-ext.podhoc.com/v1/podcasts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download \
  -H "X-Api-Key: phk_test_..."

{
  "success": true,
  "data": {
    "download_url": "https://s3.amazonaws.com/...",
    "expires_at": "2026-03-27T11:00:00+00:00",
    "format": "mp3",
    "duration_seconds": 600
  }
}

curl "https://api-ext.podhoc.com/v1/estimate-cost?duration_minutes=30&source_count=2&voice_count=2" \
  -H "X-Api-Key: phk_test_..."

{
  "success": true,
  "data": {
    "base_credits": 114,
    "credit_multiplier": 1.5,
    "final_credits": 171,
    "breakdown": {
      "base_cost": 75,
      "multi_source_bonus": 20,
      "custom_weights_bonus": 0,
      "voice_multiplier": 1.2,
      "subtotal_before_cap": 114,
      "cap_applied": null,
      "tier_max_cost": 500
    },
    "formula": "max(30, ceil(30 x 2.5)) + 20 x 1.2 = 114 x multiplier = 171"
  }
}

curl https://api-ext.podhoc.com/v1/account/credits \
  -H "X-Api-Key: phk_test_..."

{
  "success": true,
  "data": {
    "credits": 1500,
    "tier": "pro"
  }
}

import requests
import time

API_KEY = "phk_prod_your_token_here"
BASE = "https://api-ext.podhoc.com/v1"
HEADERS = {"X-Api-Key": API_KEY, "Content-Type": "application/json"}

# Step 1: Create a podcast
resp = requests.post(f"{BASE}/podcasts", headers=HEADERS, json={
    "urls": ["https://example.com/article"],
    "language": "en-US",
    "target_duration_minutes": 10,
    "style": "deep_dive",
})
podcast_id = resp.json()["data"]["podcast_id"]
print(f"Created podcast: {podcast_id}")

# Step 2: Poll until complete
while True:
    status_resp = requests.get(
        f"{BASE}/podcasts/{podcast_id}/status",
        headers={"X-Api-Key": API_KEY},
    )
    data = status_resp.json()["data"]
    print(f"Status: {data['status']} ({data['progress']}%)")
    if data["status"] == "completed":
        break
    if data["status"] == "failed":
        raise Exception("Generation failed")
    time.sleep(10)

# Step 3: Download
dl_resp = requests.get(
    f"{BASE}/podcasts/{podcast_id}/download",
    headers={"X-Api-Key": API_KEY},
)
download_url = dl_resp.json()["data"]["download_url"]

audio = requests.get(download_url)
with open("podcast.mp3", "wb") as f:
    f.write(audio.content)
print("Downloaded podcast.mp3")

const API_KEY = 'phk_prod_your_token_here';
const BASE = 'https://api-ext.podhoc.com/v1';

async function createAndDownloadPodcast() {
  // Step 1: Create a podcast
  const createRes = await fetch(`${BASE}/podcasts`, {
    method: 'POST',
    headers: { 'X-Api-Key': API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({
      urls: ['https://example.com/article'],
      language: 'en-US',
      target_duration_minutes: 10,
      style: 'deep_dive',
    }),
  });
  const { data: created } = await createRes.json();
  console.log(`Created podcast: ${created.podcast_id}`);

  // Step 2: Poll until complete
  while (true) {
    const statusRes = await fetch(
      `${BASE}/podcasts/${created.podcast_id}/status`,
      { headers: { 'X-Api-Key': API_KEY } },
    );
    const { data: status } = await statusRes.json();
    console.log(`Status: ${status.status} (${status.progress}%)`);
    if (status.status === 'completed') break;
    if (status.status === 'failed') throw new Error('Generation failed');
    await new Promise((r) => setTimeout(r, 10000));
  }

  // Step 3: Download
  const dlRes = await fetch(`${BASE}/podcasts/${created.podcast_id}/download`, {
    headers: { 'X-Api-Key': API_KEY },
  });
  const { data: dl } = await dlRes.json();

  const audioRes = await fetch(dl.download_url);
  const fs = await import('fs');
  const buffer = Buffer.from(await audioRes.arrayBuffer());
  fs.writeFileSync('podcast.mp3', buffer);
  console.log('Downloaded podcast.mp3');
}

createAndDownloadPodcast();

# Check credit balance
curl https://api-ext.podhoc.com/v1/account/credits \
  -H "X-Api-Key: $API_KEY"

# Estimate cost
curl "https://api-ext.podhoc.com/v1/estimate-cost?duration_minutes=30&source_count=1&voice_count=2" \
  -H "X-Api-Key: $API_KEY"

# Create podcast
curl -X POST https://api-ext.podhoc.com/v1/podcasts \
  -H "X-Api-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/article"], "target_duration_minutes": 10}'

# Poll status
curl https://api-ext.podhoc.com/v1/podcasts/<podcast_id>/status \
  -H "X-Api-Key: $API_KEY"

# Download
curl https://api-ext.podhoc.com/v1/podcasts/<podcast_id>/download \
  -H "X-Api-Key: $API_KEY"

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Your account has 20 credits but this request requires 113 credits.",
    "details": { "required": 113, "balance": 20 }
  },
  "meta": { "request_id": "uuid" }
}