Video Tagging API
  1. Video Analysis
Video Tagging API
  • Video Analysis
    • Analyze video from base64 data
      POST
    • Analyze uploaded video file
      POST
    • Analyze YouTube video
      POST
    • Get credit pricing
      GET
  • Schemas
    • Schemas
      • AnalysisConfig
      • AnalysisResult
      • AnalysisType
      • Body_analyze_large_video_analyze_large_video_post
      • Body_analyzeVideoFile
      • Body_analyze_small_video_analyze_small_video_post
      • HTTPValidationError
      • Body_analyze_video_analyze_video_post
      • ValidationError
      • VideoAnalysisRequest
      • VideoAnalysisResponse
      • YouTubeVideoRequest
  1. Video Analysis

Analyze YouTube video

POST
/api/v1/analyze/youtube
Analyze a YouTube video by providing its URL.
The video must be publicly accessible. Private or age-restricted videos cannot be analyzed.
Credit costs:
Base analysis: 1 credit
Cinematography: 2 credits
IAB categories: 1 credit
Topics: 1 credit
Description: 3 credits

Request

Authorization
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Successful response
Body

🟠401Unauthorized
🟠402402
🟠422Parameter Error
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://vid-tag-api.framealyzer.com/api/v1/analyze/youtube' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "youtube_url": "string",
    "analyses": [
        "string"
    ],
    "title": "string",
    "description": "string"
}'
Response Response Example
200 - Success
{
    "success": true,
    "results": {
        "cinematography_tags": [
            "Close-up Shot",
            "Golden Hour Lighting"
        ],
        "description": "A comprehensive video showcasing modern cinematography techniques..."
    },
    "metadata": {
        "youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
        "processing_method": "youtube_direct",
        "title": "Sample Video Title",
        "description": "User provided description",
        "credits_consumed": 6,
        "cost_breakdown": {
            "base_cost": 1,
            "analysis_costs": {
                "cinematography": 2,
                "description": 3
            },
            "total_cost": 6
        }
    }
}
Modified at 2025-08-18 16:21:20
Previous
Analyze uploaded video file
Next
Get credit pricing
Built with