TikTok Video AI Analysis (CustomTDK)

Fetch TikTok's AI-generated metadata (CustomTDK) for a list of video IDs — including AI-generated titles, descriptions, and keywords.

What is CustomTDK?

TikTok internally generates AI-powered TDK (Title, Description, Keywords) metadata for videos. This Actor retrieves that metadata via TikTok's CustomTDK API, which is useful for:

• SEO research — discover how TikTok understands and categorizes video content
• Content analysis — extract AI-generated descriptions and keywords at scale
• Trend monitoring — identify keyword patterns across large sets of videos

Input

Field	Type	Required	Default	Description
videoIds	string[]	✅	—	List of TikTok video IDs
concurrency	integer	❌	20	Max concurrent requests (1–100)
maxRetries	integer	❌	3	Retry attempts per video (0–10)
proxyConfig	object	❌	Apify Proxy	Proxy configuration

Example input

{
    "videoIds": [
        "7510023794342333739",
        "7388654120928311585"
    ],
    "concurrency": 20,
    "maxRetries": 3
}

Output

Each video produces one record in the default dataset with the following structure:

Successful result (status: "completed")

When AI analysis data is available (~30–40% of videos):

{
    "id": "7510023794342333739",
    "status": "completed",
    "data": {
        "extra": {
            "fatal_item_ids": [],
            "logid": "202603150306092BA646A8B0E626572C76",
            "now": 1773543969000
        },
        "itemCustomTDK": {
            "article": "",
            "desc": "¡Descubre la dedicación en el gimnasio con un toque divertido! Inspírate y ríete con nuestras gym baddies. #gymtok #gym #gymmotivation #funny",
            "keywords": [
                "dedicación en el gimnasio",
                "gym baddie motivación",
                "videos de motivación de gimnasio",
                "chicas de gimnasio",
                "risas en el gimnasio",
                "motivación para el entrenamiento",
                "gym motivation mujeres",
                "motivación de entrenamiento divertido",
                "gym girls videos",
                "momentos graciosos en el gimnasio"
            ],
            "title": "La dedicación en el gimnasio: Motivación y risas"
        },
        "log_pb": {
            "impr_id": "202603150306092BA646A8B0E626572C76"
        },
        "statusCode": 0,
        "status_code": 0,
        "status_msg": ""
    },
    "fetchedAt": "2026-03-15T03:06:09.000Z"
}

Key fields in itemCustomTDK:

Field	Description
title	AI-generated title for the video
desc	AI-generated description with hashtags
keywords	Array of AI-generated SEO keywords
article	Long-form article content (if available)

Empty result (status: "empty")

When no AI analysis data exists for the video:

{
    "id": "7388654120928311585",
    "status": "empty",
    "data": null,
    "fetchedAt": "2026-03-15T03:06:09.000Z"
}

Failed result (status: "failed")

When all retry attempts are exhausted:

{
    "id": "0000000000000000000",
    "status": "failed",
    "data": null,
    "fetchedAt": "2026-03-15T03:06:09.000Z"
}

Pricing

This Actor uses a Pay-Per-Event pricing model.

Event	Price	Description
result-with-data	$0.50 per 1,000 results ($0.0005 each)	Charged only when a video successfully returns AI analysis data

You are NOT charged for:

• Videos that return no data (status: "empty")
• Failed requests (status: "failed")

⚠️ Note: Due to TikTok's API behavior, only ~30–40% of videos have CustomTDK data available. You will only be billed for those that do.

Cost estimation

Videos queried	~Results with data (35%)	Estimated cost
1,000	~350	~$0.18
10,000	~3,500	~$1.75
100,000	~35,000	~$17.50