API Documentation
Integrate ScriptForge AI's powerful script generation capabilities into your applications with our RESTful API.
🚀 Getting Started
Our API is currently in development and will be available to Pro and Business subscribers. Sign up for early access notifications.
Request Early AccessAPI Overview
âš¡ Features
- • Generate scripts from YouTube URLs
- • Multiple script styles and formats
- • Hook generation and title packs
- • Bulk processing capabilities
- • Real-time status updates
🔧 Technical Details
- • RESTful API with JSON responses
- • Rate limiting and usage quotas
- • Webhook support for async operations
- • Comprehensive error handling
- • OpenAPI 3.0 specification
Authentication
API Key Authentication
All API requests require authentication using an API key in the Authorization header:
curl -X POST https://api.scriptforgeai.co/v1/scripts/generate \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json"
Core Endpoints
POST
/v1/scripts/generateGenerate a script from a YouTube URL
Request Body:
{
"youtubeUrl": "https://youtube.com/watch?v=VIDEO_ID",
"style": "PROFESSIONAL",
"includeHooks": true,
"includeTitlePack": true,
"targetDuration": 300
}
Response:
{
"id": "script_abc123",
"status": "completed",
"script": {
"title": "Generated Script Title",
"content": "Full script content...",
"hooks": ["Hook 1", "Hook 2", "Hook 3"],
"titlePack": ["Title 1", "Title 2", "Title 3"]
},
"metadata": {
"duration": 285,
"wordCount": 1250,
"createdAt": "2025-01-01T12:00:00Z"
}
}
GET
/v1/scripts/{id}Retrieve a specific script by ID
Response:
{
"id": "script_abc123",
"status": "completed",
"script": { ... },
"createdAt": "2025-01-01T12:00:00Z",
"updatedAt": "2025-01-01T12:05:00Z"
}
GET
/v1/scriptsList all scripts with pagination support
Query Parameters:
- •
limit: Number of results (default: 20, max: 100) - •
offset: Pagination offset - •
status: Filter by status (pending, processing, completed, failed)
Script Styles
Basic Styles (Free)
- •
PROFESSIONAL- Clean, business-appropriate - •
CASUAL- Conversational and friendly - •
EDUCATIONAL- Clear, instructional format
Premium Styles (Pro+)
- •
PERSUASIVE- Influence and convince - •
NARRATIVE- Rich storytelling format - •
ACADEMIC- Scholarly analysis style
Rate Limits & Quotas
| Subscription Tier | Monthly Quota | Rate Limit | Premium Features |
|---|---|---|---|
| Pro | 50 scripts | 10 requests/min | ✅ Hooks, Titles |
| Business | 200 scripts | 30 requests/min | ✅ All Features |
| Enterprise | Unlimited | Custom | ✅ Custom Models |
Error Handling
The API uses standard HTTP status codes and provides detailed error messages:
{
"error": {
"type": "invalid_request",
"code": "invalid_youtube_url",
"message": "The provided YouTube URL is not valid or accessible",
"details": {
"url": "https://invalid-url",
"suggestion": "Please check the URL and ensure the video is public"
}
}
}
Support & Resources
📧 Developer Support
Get help integrating our API into your applications.
api-support@scriptforgeai.co🚀 Coming Soon
- • Interactive API explorer
- • SDK libraries (Python, Node.js)
- • Webhook documentation
- • Code examples and tutorials