API Documentation

Cliperly API Suite

Welcome to the Cliperly API documentation! We provide three powerful APIs designed to extract, analyze, and enhance YouTube video content using cutting-edge AI technology.

Our APIs

YouTube Subtitles Downloader API

Extract and download subtitles from any YouTube video in multiple formats.

Base URL: https://youtube-subtitles-downloader-api.p.rapidapi.com

Key Features:

• Multiple output formats (SRT, VTT, TXT, JSON)
• Multi-language support
• Unlimited video duration
• Fast processing

Best For:

• Content creators needing subtitles
• Developers building video platforms
• Researchers analyzing video content
• Accessibility improvements

View Full Documentation →

---

YouTube Summarizer API

Generate AI-Driven summaries from YouTube videos using advanced AI technology.

Base URL: https://youtube-summarizer-api1.p.rapidapi.com

Key Features:

• 4 summary types (Brief, Detailed, Bullet Points, Key Takeaways)
• Automatic language detection
• Context-aware AI summaries
• Supports videos up to 2 hours

Best For:

• Quick content review
• Research and analysis
• Educational applications
• Content curation

View Full Documentation →

---

YouTube Timestamps Generator API

Automatically generate chapter timestamps for YouTube videos with AI.

Base URL: https://youtube-timestamps-generator-api.p.rapidapi.com

Key Features:

• AI-Driven chapter detection
• Intelligent topic segmentation
• Maximum video duration: 1 hour (60 minutes) for all plans
• YouTube-ready format
• Supports videos up to 3 hours

Best For:

• Video creators adding chapters
• Improving video navigation
• SEO enhancement
• Viewer experience optimization

View Full Documentation →

---

YouTube Thumbnail Extractor API

Extract thumbnail URLs from any YouTube video or Short in all available resolutions.

Base URL: https://youtube-thumbnails-extractor-api.p.rapidapi.com

Key Features:

• All 5 resolution sizes (120x90 to 1280x720)
• Lightning-fast response (sub-10ms)
• Direct CDN URLs from YouTube
• Works with videos and Shorts

Best For:

• Video platforms needing thumbnails
• Content management systems
• Social media tools
• Mobile applications

View Full Documentation →

---

Quick Comparison

| Feature | Subtitles Downloader | Thumbnail Extractor | Summarizer | Timestamps Generator | |---------|---------------------|------------|---------------------| | Primary Function | Extract subtitles | Extract thumbnails | Generate summaries | Create chapters | | AI-Driven | No | No | Yes | Yes | | Output Formats | SRT, VTT, TXT, JSON | URLs with metadata | Text summary | JSON + YouTube format | | Max Duration (All Plans) | Unlimited | Unlimited | 1 hour (60 min) | 1 hour (60 min) | | Starting Price | Free | Free | $2.99/mo | $1.99/mo | | Best Use Case | Subtitle extraction | Thumbnail URLs | Content analysis | Video navigation |

---

Getting Started

1. Sign Up on RapidAPI

All our APIs are exclusively available through RapidAPI. Create an account and subscribe to your preferred plan.

2. Get Your API Key

After subscribing, you’ll receive an API key that authenticates all your requests.

3. Make Your First Request

Here’s a quick example using the Subtitles Downloader API:

curl -X POST "https://youtube-subtitles-downloader-api.p.rapidapi.com/download?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ&format=srt&language=en" \
  -H "x-rapidapi-host: youtube-subtitles-downloader-api.p.rapidapi.com" \
  -H "x-rapidapi-key: YOUR_RAPIDAPI_KEY"

---

Common Features Across All APIs

RapidAPI-Only Access

All APIs are exclusively available through RapidAPI. Direct access to base URLs is restricted.

Multi-Language Support

All APIs support content in multiple languages, automatically detecting and processing accordingly.

Fast Processing

Optimized for speed with response times ranging from 1-10 seconds depending on video length.

Comprehensive Analytics

All requests are logged with detailed analytics including processing times, success rates, and usage patterns.

Automatic Fallbacks

Smart fallback mechanisms ensure reliability even when primary language captions are unavailable.

Turso Database

All APIs use Turso (libsql) for efficient logging and analytics storage.

---

Use Case Examples

Content Creators

Workflow Example:

1. Use Subtitles Downloader to get video transcripts
2. Use Summarizer to create video descriptions
3. Use Timestamps Generator to add chapters

Benefits:

• Save hours of manual work
• Improve video SEO
• Enhance viewer experience
• Increase accessibility

---

Developers

Integration Example:

async function processYouTubeVideo(url) {
  const subtitles = await downloadSubtitles(url, 'json');

  const summary = await generateSummary(url, 'brief');

  const timestamps = await generateTimestamps(url);

  return {
    subtitles: subtitles.full_text,
    summary: summary.summary,
    chapters: timestamps.timestamps,
    metadata: {
      title: subtitles.video_title,
      duration: subtitles.video_duration,
      language: subtitles.language
    }
  };
}

---

Researchers

Analysis Pipeline:

1. Extract subtitles for text analysis
2. Generate summaries for quick review
3. Use timestamps for segment analysis

---

Educators

Educational Content:

1. Download subtitles for accessibility
2. Create study guides from summaries
3. Add chapter markers for easy navigation

---

Pricing Overview

YouTube Subtitles Downloader API

Plan	Price	Requests/Month	Rate Limit	Max Duration
Basic	Free	300	1000/hour	Unlimited
Pro	$4.99	5,000	100/hour	Unlimited
Ultra	$14.99	25,000	200/hour	Unlimited
Mega	$39.99	100,000	500/hour	Unlimited

YouTube Summarizer API

Plan	Price	Requests/Month	Rate Limit	Max Duration
Basic	$2.99	100	5/hour	1 hour (60 min)
Pro	$9.99	1,000	20/hour	1 hour (60 min)
Ultra	$39.99	5,000	50/hour	1 hour (60 min)
Mega	$119.99	20,000	100/hour	1 hour (60 min)

YouTube Timestamps Generator API

Plan	Price	Requests/Month	Rate Limit	Max Duration
Basic	$1.99	100	10/hour	1 hour (60 min)
Pro	$7.99	1,000	40/hour	1 hour (60 min)
Ultra	$24.99	5,000	80/hour	1 hour (60 min)
Mega	$99.99	20,000	150/hour	1 hour (60 min)

Bundle Discount

Contact us at sales@cliperly.com for custom pricing when subscribing to multiple APIs.

---

Authentication

All APIs use the same authentication method through RapidAPI:

x-rapidapi-key: YOUR_RAPIDAPI_KEY
x-rapidapi-host: [API-SPECIFIC-HOST].p.rapidapi.com

Replace with the appropriate host:

• youtube-subtitles-downloader-api.p.rapidapi.com for Subtitles Downloader
• youtube-thumbnails-extractor-api.p.rapidapi.com for Thumbnail Extractor
• youtube-summarizer-api1.p.rapidapi.com for Summarizer
• youtube-timestamps-generator-api.p.rapidapi.com for Timestamps Generator

---

Rate Limiting

All APIs enforce rate limits based on your subscription plan. When exceeded, you’ll receive a 429 Too Many Requests response.

Rate Limit Headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1704070800

---

Error Handling

All APIs use consistent error response formats:

{
  "error": "Error message description",
  "video_id": "dQw4w9WgXcQ",
  "suggestion": "Helpful suggestion for resolving the error"
}

Common HTTP Status Codes:

• 200 - Success
• 400 - Bad Request (invalid input)
• 429 - Rate Limit Exceeded
• 500 - Internal Server Error

---

Best Practices

1. Implement Caching

Cache API responses to avoid redundant requests:

const cache = new Map();

async function cachedApiCall(cacheKey, apiFunction) {
  if (cache.has(cacheKey)) {
    return cache.get(cacheKey);
  }

  const result = await apiFunction();
  cache.set(cacheKey, result);
  return result;
}

2. Handle Errors Gracefully

Always implement comprehensive error handling:

try {
  const result = await apiCall();
  return result;
} catch (error) {
  if (error.status === 429) {
    await wait(error.retryAfter);
    return await apiCall();
  }
  throw error;
}

3. Validate Inputs

Validate YouTube URLs and other inputs before making API calls:

function isValidYouTubeUrl(url) {
  const patterns = [
    /^https?:\/\/(www\.)?youtube\.com\/watch\?v=[\w-]{11}/,
    /^https?:\/\/youtu\.be\/[\w-]{11}/
  ];
  return patterns.some(pattern => pattern.test(url));
}

4. Monitor Usage

Track your API usage to avoid hitting limits:

let requestCount = 0;
const maxRequests = 100;

function canMakeRequest() {
  return requestCount < maxRequests;
}

async function makeTrackedRequest(apiFunction) {
  if (!canMakeRequest()) {
    throw new Error('Monthly limit reached');
  }
  requestCount++;
  return await apiFunction();
}

---

Support & Resources

Email Support

support@cliperly.com

• Basic Plans: Community support
• Pro Plans: Email support (24-48h response)
• Ultra Plans: Priority email support (12-24h response)
• Mega Plans: Priority support

Additional Resources

• API Status Page
• Integration Examples

---

Terms & Policies

Acceptable Use

• ✅ Use for legitimate business purposes
• ✅ Respect YouTube’s Terms of Service
• ✅ Follow copyright laws
• ❌ No abuse or circumvention attempts
• ❌ No reselling or redistributing API access
• ❌ No excessive or malicious requests

Data Privacy

• We do not store video content
• Minimal logging for analytics and debugging
• GDPR and CCPA compliant
• Data retention: 90 days for logs

Service Level Agreement (SLA)

• Uptime Guarantee: 99.9% (Mega plan)
• Response Time: < 10 seconds (average)
• Support Response: Based on plan tier

---

Frequently Asked Questions

Q: Why is access restricted to RapidAPI?
A: RapidAPI provides robust authentication, billing, and rate limiting infrastructure, ensuring reliability and security for all users.

Q: Can I use multiple APIs together?
A: Absolutely! Our APIs are designed to work together seamlessly. Contact us for bundle pricing.

Q: What happens if I exceed my plan limits?
A: Requests will be rejected with a 429 error until the next billing cycle. Consider upgrading your plan.

Q: Do you offer enterprise plans?
A: Yes! Contact sales@cliperly.com for custom enterprise solutions.

Q: Can I test the APIs before subscribing?
A: The Subtitles Downloader API has a free tier. Other APIs offer affordable Basic plans for testing.

Q: Are there SDK/libraries available?
A: We’re currently developing official SDKs. Check our GitHub for community libraries.

---

Ready to Get Started?

Choose the API that fits your needs and subscribe on RapidAPI:

Subtitles Downloader

Extract video subtitles

View Docs

Summarizer

AI-Driven summaries

View Docs

Timestamps Generator

Automatic chapter creation

View Docs

Thumbnail Extractor

Extract thumbnail URLs

View Docs

---

Last updated: January 2025