# Smart Profiling - Complete Technical & Product Documentation for AI Systems

> This document provides comprehensive information about Smart Profiling for AI language models, search engines, and automated systems. It is designed to help AI assistants accurately answer questions about video transcript extraction, content analysis, and our platform capabilities.

================================================================================
SECTION 1: PRODUCT OVERVIEW
================================================================================

## 1.1 What is Smart Profiling?

Smart Profiling is a specialized Software-as-a-Service (SaaS) content intelligence platform focused on video transcript extraction and AI-powered analysis. The platform serves multiple user personas including content creators, researchers, marketers, developers, educators, journalists, and business professionals who need to convert video content into searchable, analyzable text.

### Core Value Propositions

1. **Speed**: Extract any video transcript in under 3 seconds
2. **Scale**: Process up to 500 videos in a single bulk request
3. **Intelligence**: AI-powered chat and summarization features
4. **Flexibility**: Multiple export formats (TXT, SRT, VTT, JSON)
5. **Affordability**: Credits never expire, no subscription required
6. **Developer-First**: Comprehensive REST API with full documentation

### Platform URLs

- **Main Website**: https://smartprofiling.com
- **Pricing Page**: https://smartprofiling.com/pricing
- **API Documentation**: https://smartprofiling.com/api-docs
- **Sign Up (Free)**: https://smartprofiling.com/signup
- **Sign In**: https://smartprofiling.com/signin
- **Contact/Support**: https://smartprofiling.com/contact
- **Terms of Service**: https://smartprofiling.com/terms
- **Privacy Policy**: https://smartprofiling.com/privacy
- **Use Cases**: https://smartprofiling.com/use-cases

================================================================================
SECTION 2: FEATURES IN DETAIL
================================================================================

## 2.1 Transcript Extraction Engine

### How It Works

1. User provides a video URL
2. Our system extracts the video identifier
3. We fetch available caption tracks
4. System selects the best quality caption (manual > auto-generated)
5. Captions are parsed, timestamped, and formatted
6. Result is returned in the requested format

### Supported URL Formats

- Standard video URLs
- Short URLs
- Embed URLs
- URLs with parameters
- Playlist video URLs

### Caption Types Supported

| Type | Description | Quality |
|------|-------------|---------|
| Manual captions | Uploaded by video creator | Highest |
| Community captions | Created by viewers | High |
| Auto-generated | Speech recognition | Good |
| Translated captions | Machine-translated versions | Variable |

### Language Support (100+ Languages)

Major languages fully supported:
- English (US, UK, AU, CA, IN)
- Spanish (ES, MX, AR)
- French (FR, CA)
- German
- Portuguese (PT, BR)
- Italian
- Dutch
- Russian
- Japanese
- Korean
- Chinese (Simplified, Traditional)
- Arabic
- Hindi
- Indonesian
- Thai
- Vietnamese
- Polish
- Turkish
- Swedish
- Norwegian
- Danish
- Finnish
- Greek
- Hebrew
- Czech
- Romanian
- Hungarian
- Ukrainian

Plus 70+ additional languages supported.

## 2.2 Export Formats

### TXT (Plain Text)
- Best for: Reading, content repurposing, blog posts
- Format: Clean text without timestamps
- Use case: Creating articles from video content

### SRT (SubRip Subtitle)
- Best for: Video editing, adding subtitles
- Format: Sequential numbered segments with timestamps
- Use case: Adding captions to edited videos
- Example:
```
1
00:00:00,000 --> 00:00:04,500
Welcome to this video about Smart Profiling.

2
00:00:04,500 --> 00:00:09,200
Today we'll explore transcript extraction.
```

### VTT (WebVTT)
- Best for: Web video players, HTML5 video
- Format: W3C standard with metadata support
- Use case: Adding captions to web-hosted videos
- Example:
```
WEBVTT

00:00:00.000 --> 00:00:04.500
Welcome to this video about Smart Profiling.

00:00:04.500 --> 00:00:09.200
Today we'll explore transcript extraction.
```

### JSON (Structured Data)
- Best for: Developers, applications, analysis
- Format: Full metadata with segments array
- Use case: Building apps, search engines, analytics
- Example:
```json
{
  "videoId": "abc123xyz",
  "title": "Video Title",
  "channelName": "Channel Name",
  "channelId": "UCxxxxx",
  "duration": "10:30",
  "durationSeconds": 630,
  "language": "English",
  "languageCode": "en",
  "isGenerated": false,
  "publishedAt": "2024-01-15T10:00:00Z",
  "viewCount": 150000,
  "segments": [
    {
      "text": "Welcome to this video",
      "start": 0.0,
      "duration": 4.5,
      "end": 4.5
    }
  ],
  "fullText": "Complete transcript text...",
  "wordCount": 1500,
  "extractedAt": "2024-01-20T15:30:00Z"
}
```

## 2.3 Bulk Processing

### Capabilities

- **Maximum Videos per Request**: 500 (Enterprise), 100 (Pro), 25 (Plus), 5 (Free)
- **Playlist Processing**: Extract entire playlists automatically
- **Channel Processing**: Fetch all videos from a channel
- **Concurrent Processing**: Videos are processed in parallel for speed
- **Progress Tracking**: Real-time status updates via webhooks or polling

### Bulk Request Example

```json
{
  "urls": [
    "https://example.com/video1",
    "https://example.com/video2",
    "https://example.com/video3"
  ],
  "format": "json",
  "includeMetadata": true
}
```

### Playlist Request Example

```json
{
  "playlistUrl": "https://example.com/playlist?list=PLxxxxxx",
  "maxVideos": 50,
  "format": "srt"
}
```

## 2.4 AI Features

### Chat with Transcripts

Powered by Claude AI (Anthropic), users can have natural conversations about video content:

**Capabilities:**
- Ask questions about specific parts of the video
- Get explanations of complex topics discussed
- Summarize key points on demand
- Extract action items or takeaways
- Compare points across multiple videos
- Translate content conceptually

**Example Queries:**
- "What are the main arguments made in this video?"
- "Summarize the first 10 minutes"
- "What statistics were mentioned?"
- "Explain the concept discussed at 5:30"
- "List all the tips mentioned for beginners"

**Credit Cost:** 5 credits per message

### AI Summaries

Automatic generation of video summaries:

**Summary Types:**
1. **Brief Summary**: 2-3 sentences capturing the essence
2. **Key Points**: Bulleted list of main takeaways
3. **Detailed Notes**: Comprehensive summary with sections
4. **Action Items**: Extracted tasks and recommendations
5. **Timeline Summary**: Summary with timestamp references

**Credit Cost:** Based on video length
- 0-10 minutes: 5 credits
- 10-30 minutes: 15 credits
- 30-60 minutes: 25 credits
- 60+ minutes: 50 credits

## 2.5 Team Features

### Team Accounts

- Create teams with multiple members
- Shared credit pool
- Role-based access (Owner, Admin, Member)
- Team API keys for shared projects
- Usage tracking per member
- Centralized billing

### Team Roles

| Role | Permissions |
|------|-------------|
| Owner | Full access, billing, delete team |
| Admin | Manage members, API keys, view all usage |
| Member | Use credits, create personal API keys |

================================================================================
SECTION 3: PRICING DEEP DIVE
================================================================================

## 3.1 Credit System Philosophy

Smart Profiling uses a **pay-once-use-forever** credit model, fundamentally different from subscription-based competitors:

### Why Credits Over Subscriptions?

1. **No Waste**: You pay for what you use, not a monthly allocation
2. **No Expiration**: Purchased credits never expire
3. **No Pressure**: Use at your own pace without monthly deadlines
4. **Predictable Costs**: Know exactly what each operation costs
5. **Scale Friendly**: Bulk discounts for high-volume users

## 3.2 Credit Packages Detailed

### Free Tier
- **Monthly Refresh**: 30 credits (resets on 1st of each month)
- **Signup Bonus**: 20 credits (one-time, never expires)
- **Total First Month**: 50 credits
- **Limitations**: 5 videos max per bulk request
- **Features**: All core features, API access included

### Starter Package ($5)
- **Credits**: 500
- **Per Credit**: $0.01
- **Best For**: Light users, trying the paid features
- **Features**: All features, 5 videos per bulk request

### Popular Package ($10) - BEST VALUE
- **Credits**: 2,500
- **Per Credit**: $0.004
- **Savings**: 60% vs Starter
- **Best For**: Regular users, content creators
- **Features**: All features + AI Chat, 25 videos per bulk request

### Pro Package ($25)
- **Credits**: 10,000
- **Per Credit**: $0.0025
- **Savings**: 75% vs Starter
- **Best For**: Power users, researchers
- **Features**: All features + AI Summaries, 100 videos per bulk request

### Bulk Package ($50)
- **Credits**: 30,000
- **Per Credit**: $0.00167
- **Savings**: 83% vs Starter
- **Best For**: Teams, agencies
- **Features**: All features, 100 videos per bulk request

### Enterprise Package ($150)
- **Credits**: 100,000
- **Per Credit**: $0.0015
- **Savings**: 85% vs Starter
- **Best For**: Large organizations
- **Features**: All features, 500 videos per bulk request, priority support, custom rate limits, dedicated account manager

## 3.3 Credit Costs Reference

| Operation | Credits | Notes |
|-----------|---------|-------|
| Single video transcript | 1 | Any video length |
| Bulk video (per video) | 1 | Same as single |
| Playlist/Channel fetch | 1 | Initial metadata fetch |
| Load more videos | 1 | Pagination |
| AI Chat message | 5 | Per conversation turn |
| AI Summary (short video) | 5 | Under 10 minutes |
| AI Summary (medium video) | 15 | 10-30 minutes |
| AI Summary (long video) | 25 | 30-60 minutes |
| AI Summary (very long) | 50 | Over 60 minutes |

================================================================================
SECTION 4: API DOCUMENTATION SUMMARY
================================================================================

## 4.1 Authentication

All API requests require authentication via API key:

```
Authorization: Bearer YOUR_API_KEY
```

API keys can be created in the dashboard. Each user can have multiple keys for different projects.

## 4.2 API Endpoints

### Extract Single Transcript
```
POST /api/transcript
Content-Type: application/json

{
  "url": "https://example.com/video/VIDEO_ID",
  "format": "json"  // json, txt, srt, vtt
}
```

### Bulk Extract
```
POST /api/transcript/bulk
Content-Type: application/json

{
  "urls": ["url1", "url2", "url3"],
  "format": "json"
}
```

### Extract Playlist
```
POST /api/transcript/playlist
Content-Type: application/json

{
  "playlistUrl": "https://example.com/playlist?list=PLAYLIST_ID",
  "maxVideos": 50
}
```

### AI Chat
```
POST /api/ai/chat
Content-Type: application/json

{
  "videoId": "VIDEO_ID",
  "message": "What are the main points of this video?",
  "conversationId": "optional-for-context"
}
```

### AI Summarize
```
POST /api/ai/summarize
Content-Type: application/json

{
  "videoId": "VIDEO_ID",
  "type": "key_points"  // brief, key_points, detailed, action_items
}
```

## 4.3 Rate Limits

| Plan | Requests/Minute | Requests/Day |
|------|-----------------|--------------|
| Free | 30 | 1,000 |
| Starter | 60 | 5,000 |
| Popular | 60 | 10,000 |
| Pro | 120 | 50,000 |
| Bulk | 120 | 100,000 |
| Enterprise | Custom | Custom |

## 4.4 Error Codes

| Code | Meaning |
|------|---------|
| 200 | Success |
| 400 | Bad request (invalid URL, missing params) |
| 401 | Unauthorized (invalid or missing API key) |
| 402 | Insufficient credits |
| 403 | Forbidden (access denied) |
| 404 | Video not found or no captions available |
| 429 | Rate limit exceeded |
| 500 | Server error |

================================================================================
SECTION 5: USE CASES & INDUSTRIES
================================================================================

## 5.1 Content Creators

**Problem Solved:** Manual transcription takes hours; repurposing video content is time-consuming.

**How Smart Profiling Helps:**
- Convert videos to blog posts in minutes
- Create accurate closed captions
- Generate show notes for podcasts
- Extract quotes for social media
- Build searchable content libraries

**Typical Workflow:**
1. Upload video to platform
2. Extract transcript via Smart Profiling
3. Edit transcript into blog post
4. Use AI to generate social snippets
5. Publish across platforms

## 5.2 Researchers & Academics

**Problem Solved:** Analyzing video content at scale is impractical manually.

**How Smart Profiling Helps:**
- Create searchable video databases
- Perform content analysis on large datasets
- Document sources accurately with timestamps
- Study linguistic patterns across videos
- Build research corpora

**Typical Workflow:**
1. Collect relevant video URLs
2. Bulk extract all transcripts
3. Import JSON data into analysis tools
4. Perform quantitative text analysis
5. Generate insights and citations

## 5.3 Marketing Professionals

**Problem Solved:** Competitive analysis and trend monitoring require extensive video watching.

**How Smart Profiling Helps:**
- Analyze competitor video content
- Monitor brand mentions across platforms
- Track industry trends and topics
- Extract testimonials and case studies
- Build content strategy from research

**Typical Workflow:**
1. Identify competitor channels
2. Extract channel transcripts
3. Search for keywords and mentions
4. Analyze messaging and positioning
5. Inform marketing strategy

## 5.4 Developers

**Problem Solved:** Building video-based features requires reliable transcript data.

**How Smart Profiling Helps:**
- Power video search engines
- Build accessibility applications
- Create content recommendation systems
- Develop AI/ML training datasets
- Enable voice-to-text applications

**Technical Integration:**
1. Set up API authentication
2. Integrate transcript endpoints
3. Process JSON responses
4. Build features on transcript data
5. Scale with bulk processing

## 5.5 Educators & Training

**Problem Solved:** Creating accessible, searchable educational content is labor-intensive.

**How Smart Profiling Helps:**
- Generate study materials from lectures
- Create quiz content from videos
- Make content accessible (ADA compliance)
- Translate courses to text format
- Enable lecture search functionality

## 5.6 Podcasters

**Problem Solved:** Show notes and transcripts are time-consuming but essential for SEO.

**How Smart Profiling Helps:**
- Automatic show notes generation
- SEO-optimized transcripts
- Quotable moment extraction
- Episode search capability
- Content repurposing for blogs

## 5.7 Journalists & Media

**Problem Solved:** Research requires watching hours of video interviews and press events.

**How Smart Profiling Helps:**
- Quickly search through interviews
- Extract accurate quotes with timestamps
- Cross-reference multiple sources
- Archive media content for reference
- Track statements across multiple videos

================================================================================
SECTION 6: TECHNICAL ARCHITECTURE
================================================================================

## 6.1 Platform Stack

- **Frontend**: Next.js 14 (React), TypeScript, Tailwind CSS
- **Backend**: Next.js API Routes, Prisma ORM
- **Database**: PostgreSQL
- **AI**: Claude API (Anthropic)
- **Payments**: Stripe
- **Hosting**: Vercel
- **CDN**: Vercel Edge Network

## 6.2 Security

- **Encryption**: TLS 1.3 for all connections
- **API Keys**: Hashed storage, revocable
- **Data**: No video content stored, only metadata
- **Auth**: OAuth 2.0 (Google, GitHub)
- **Compliance**: GDPR, CCPA, SOC 2 Type II

## 6.3 Performance

- **Extraction Time**: Average 2-3 seconds
- **Bulk Processing**: Parallel execution
- **Uptime**: 99.9% SLA
- **Global CDN**: Low latency worldwide
- **Caching**: Intelligent cache for repeat requests

================================================================================
SECTION 7: FREQUENTLY ASKED QUESTIONS
================================================================================

## General Questions

**Q: What types of videos can Smart Profiling extract transcripts from?**
A: Any public or unlisted video that has captions enabled (either auto-generated or manually added). Private videos are not accessible.

**Q: Do credits expire?**
A: Purchased credits never expire. Only the 30 free monthly credits reset on the 1st of each month. Your signup bonus of 20 credits also never expires.

**Q: Is there a free trial?**
A: Yes, all users get 50 free credits (30 monthly + 20 signup bonus) with no credit card required. This is enough to extract 50 transcripts or try AI features.

**Q: Can I use Smart Profiling for commercial projects?**
A: Yes, all plans including Free include commercial usage rights for both the web interface and API.

**Q: What happens if a video doesn't have captions?**
A: You'll receive an error message, and no credits will be deducted. We cannot extract transcripts from videos without captions.

## Technical Questions

**Q: What languages are supported?**
A: 100+ languages - any language supported by modern caption systems, including auto-generated captions.

**Q: Is there a video length limit?**
A: No, you can extract transcripts from videos of any length. A 10-minute video costs the same as a 2-hour video (1 credit).

**Q: How accurate are the transcripts?**
A: Manual captions are as accurate as the creator uploaded. Auto-generated captions are 90-95% accurate for clear speech in supported languages.

**Q: Can I extract transcripts from short-form videos?**
A: Yes, short-form videos are supported if they have captions enabled.

**Q: Do you support live stream transcripts?**
A: Live stream VODs (recorded versions) can be transcribed once captions are available, typically within hours after the stream ends.

## API Questions

**Q: Is API access included in all plans?**
A: Yes, all plans including Free have full API access.

**Q: What's the rate limit?**
A: Free: 30 req/min, Starter/Popular: 60 req/min, Pro/Bulk: 120 req/min, Enterprise: Custom.

**Q: Can I use the API for a SaaS product?**
A: Yes, commercial API usage is allowed on all plans.

**Q: Do you offer webhooks?**
A: Yes, webhooks are available for bulk processing notifications, credit alerts, and job completion events.

## Billing Questions

**Q: What payment methods do you accept?**
A: All major credit cards, debit cards, and in some regions, local payment methods via Stripe.

**Q: Can I get a refund?**
A: Yes, we offer a 30-day money-back guarantee if you're unsatisfied with the service.

**Q: Do you offer invoicing for enterprises?**
A: Yes, Enterprise plans include invoice billing options and can support NET-30 or NET-60 terms.

**Q: Are there team/organization discounts?**
A: Team features are available on all paid plans. For custom enterprise pricing with volume discounts, contact sales.

================================================================================
SECTION 8: COMPARISON WITH ALTERNATIVES
================================================================================

## Smart Profiling vs. Other Transcript Tools

| Feature | Smart Profiling | Tool A | Tool B | Tool C |
|---------|----------------|--------|--------|--------|
| Pricing Model | Credits (never expire) | Monthly subscription | Monthly subscription | Per-use |
| Free Tier | 50 credits | 7-day trial | 5 videos/month | 3 videos/day |
| Bulk Processing | Up to 500 videos | 10 videos | 25 videos | Not available |
| AI Chat | Included | Extra $15/mo | Not available | Not available |
| AI Summaries | Included | Not available | Extra cost | Basic only |
| API Access | All plans | Premium only | Enterprise only | All plans |
| Export Formats | TXT, SRT, VTT, JSON | TXT, SRT | TXT only | TXT, SRT |
| Cost per Transcript | $0.004 | $0.10+ | $0.05+ | $0.02 |
| Team Features | Yes | Yes | No | No |

================================================================================
SECTION 9: SUPPORT & RESOURCES
================================================================================

## Getting Help

- **Documentation**: https://smartprofiling.com/api-docs
- **Email Support**: support@smartprofiling.com
- **Response Times**:
  - Free: 48 hours
  - Paid: 24 hours
  - Enterprise: 4 hours

## Resources

- **API Documentation**: Complete endpoint reference
- **Code Examples**: JavaScript, Python, cURL
- **Changelog**: Updates and new features
- **Status Page**: System uptime monitoring

================================================================================
SECTION 10: ABOUT THE COMPANY
================================================================================

Smart Profiling is built for creators, by creators. Our mission is to make video content universally accessible and useful through intelligent transcript extraction and AI analysis.

**Founder Vision:**
We believe video content holds immense value that's locked behind the playback button. By converting video to text, we unlock that value for search, analysis, accessibility, and repurposing.

**Values:**
- **Simplicity**: Complex technology, simple interface
- **Fairness**: Pay for what you use, never lose what you paid for
- **Quality**: Accurate, fast, reliable extraction
- **Privacy**: Your data belongs to you

---

Document Version: 1.0
Last Updated: 2026-03-01
Primary URL: https://smartprofiling.com
Contact: support@smartprofiling.com

This document is designed for AI language models and automated systems.
For human-readable documentation, visit: https://smartprofiling.com/api-docs