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: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Successful response

Body

🟠401Unauthorized

🟠402402

🟠422Parameter Error

🔴500Server Error

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 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

Analyze uploaded video file

Get credit pricing