TubeOnAI API Documentation: Setup, Usage, and Best Practices

TubeOnAI Developer API — User Guide

Easily integrate AI-powered summaries into your applications using the TubeOnAI Developer API.

Supported Content Types

TubeOnAI can summarize the following content sources: | Content Type | Description | Examples | | ---- | | YouTube Videos | Any public YouTube video | Tutorials, lectures, podcasts | | Web Articles | Blog posts, news, pages | Medium articles, news sites | | Documents | PDF, Word, TXT files | Reports, papers, eBooks | | Rumble Videos | Public Rumble videos | Commentary, news clips |

Getting Started

1. Create Your API Key

API keys are created inside the TubeOnAI dashboard:

Log in at: https://web.tubeonai.com
Go to Settings
Open Developer Features
Click Create New API Key
Name it (e.g., My App Integration)
Create the key and store it securely Important: API keys are shown only once. Save them in a secure location. Example: pk_live_**********************************

2. Test Your API Key

curl -X GET "https://app.tubeonai.com/api/developer/v1/usage/credits" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Successful response:

{
  "success": true,
  "data": {
    "balance": {
      "available": 3600,
      "used_today": 0,
      "unit": "seconds"
    }
  }
}

Creating Summaries

Request Body Structure

{
  "url": "string (required)",
  "type": "youtube | article | document | rumble",
  "options": {
    "detail_level": "concise | detailed | comprehensive",
    "tone": "professional | casual | academic",
    "model": "string (optional)",
    "custom_prompt": "string (optional)"
  },
  "webhook_url": "string (optional)"
}

Content-Type Examples

YouTube Video

{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "type": "youtube",
  "options": { "detail_level": "detailed", "tone": "professional" }
}

Short URL:

{
  "url": "https://youtu.be/dQw4w9WgXcQ",
  "options": { "detail_level": "comprehensive" }
}

Web Article

{
  "url": "https://example.com/blog/interesting-article",
  "type": "article",
  "options": { "detail_level": "concise", "tone": "casual" }
}

PDF

{
  "url": "https://example.com/reports/annual-report.pdf",
  "type": "document",
  "options": { "detail_level": "comprehensive", "tone": "academic" }
}

DOCX

{
  "url": "https://example.com/docs/meeting-notes.docx",
  "type": "document",
  "options": { "detail_level": "concise", "tone": "professional" }
}

TXT

{
  "url": "https://example.com/files/readme.txt",
  "type": "document",
  "options": { "detail_level": "detailed" }
}

Rumble Video

{
  "url": "https://rumble.com/v5e0nip-video-title.html",
  "type": "rumble",
  "options": { "detail_level": "detailed", "tone": "professional" }
}

Request Options Explained

| Field | Values | Description | | ---- | | type | youtube, article, document, rumble | Content source | | detail_level | concise, detailed (default), comprehensive | Summary length | | tone | professional (default), casual, academic | Writing style | | custom_prompt | Text | Custom instructions | | webhook_url | URL | Automatic callback |

Response Examples

Summary Request Created

{
  "success": true,
  "message": "Summary request created successfully.",
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "pending",
    "estimated_time": "2-5 minutes"
  }
}

Status Values:

pending
processing
completed
failed

Retrieve Summary Result

curl -X GET "https://app.tubeonai.com/api/developer/v1/summaries/SUMMARY_ID" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Completed example:

{
  "success": true,
  "data": {
    "status": "completed",
    "title": "How to Build a Successful Startup",
    "summary": "This video covers...",
    "key_points": [
      "Start with a problem worth solving",
      "Build a minimum viable product",
      "Focus on customer feedback"
    ],
    "duration": 1200
  }
}

Full cURL Library

Includes examples for:

YouTube
Articles
Documents
TXT
Rumble (All formatted versions remain unchanged.)

Repurposing Summaries

Request Schema

{
  "summary_id": "string",
  "format": "linkedin | twitter | blog | email | bullet_points | custom",
  "prompt": "optional",
  "tone": "optional"
}

Supported Repurpose Formats

| Format | Output Style | Use Case | | ---- | | linkedin | Optimized LinkedIn post | Professional posts | | twitter | 5-tweet thread | Social content | | blog | Long-form content | SEO and articles | | email | Newsletter style | Campaigns | | bullet_points | Key takeaways | Presentations | | custom | Fully custom | Scripts, sales copy |

Usage and Rate Limits

Check Credits

curl -X GET "https://app.tubeonai.com/api/developer/v1/usage/credits" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

Check Usage

curl -X GET "https://app.tubeonai.com/api/developer/v1/usage"

Processing Time Overview

| Content Type | Average Time | Maximum | | ---- | | YouTube | 2–5 min | 60 min | | Web Article | 1–3 min | — | | Podcast | 3–7 min | 120 min | | Document | 2–4 min | 500 pages | | Rumble | 3–5 min | 60 min | Repeated content is cached for faster responses.

Common Issues and Fixes

Unauthenticated

Missing or incorrect API key
Ensure keys start with pk_live_
Confirm the key is active

Insufficient Credits

Check remaining usage
Upgrade or purchase additional credits

Rate Limit Exceeded

Limit: 60 requests per minute
Add retry/delay logic

Long Processing Time

Large content can take longer
Poll every 10–15 seconds
Retry if stuck beyond a reasonable threshold

Best Practices

Avoid

Exposing API keys on the front-end
Sending duplicate or spam requests
Using production keys for local testing

API Reference Summary

Base URL

https://app.tubeonai.com

Authorization Header

Authorization: Bearer pk_live_YOUR_API_KEY_HERE

Endpoints

| Endpoint | Method | Description | | ---- | | /summaries | POST | Create summary | | /summaries/{id} | GET | Check summary | | /summaries | GET | List summaries | | /repurpose | POST | Repurpose | | /usage/credits | GET | Check credits | | /usage | GET | Usage stats |

Appearance