Search media content by tags and free text

POST

https://mma.tvunetworks.com/api/search/v1/i/combtag

Searches TVU media content across multiple types (assets, captions, sources) using structured tag filters combined with an optional free-text query. Tag filters include person IDs, story IDs, media UIDs, feature keywords, and object categories (objectSources, objectUserIds, objectGroupIds). When AI search is enabled, free-text queries are automatically parsed to extract person name filters and keyword intents. Use the 'source' array to restrict which content types are searched. Results are paginated and sorted per the 'sort' parameter. Session ID required.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://mma.tvunetworks.com/api/search/v1/i/combtag' \
--header 'SID: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "from": "monitor",
    "pageNum": 1,
    "pageSize": 8,
    "permission": {
        "enable": true
    },
    "query": "",
    "sessionid": "25D978D710BD4C39B1EFB1644AF72631",
    "sort": 1,
    "source": [
        "source"
    ],
    "tags": {
        "feature": [],
        "objectEvents": [],
        "objectGeo": [],
        "objectGroupIds": [
            "bc3a83594dcd41288c52dac3c552da3d",
            "52dd9380410d4430b23c35d986ed23aa"
        ],
        "objectSources": [
            "1447853763061747712"
        ],
        "objectTags": [],
        "objectUserIds": [
            "4668211d13424faea1677b51810cb488"
        ],
        "personids": [],
        "storyids": []
    },
    "tsrange": {
        "starttime": 1770505900337,
        "endtime": 1778281900337
    },
    "userid": "enzoricardo@zohomail.com"
}'

Response Example

{
    "code": 0,
    "message": "succ",
    "data": {
        "list": [
            {
                "DataObjectId": "1447853763061747712",
                "Score": null,
                "hit_data": {
                    "asset_id": "01088b2511ca4671908e0bae76579f89",
                    "docid": "",
                    "expl": null,
                    "index": "",
                    "lang": "en",
                    "mpd_info": [],
                    "objectTag": null,
                    "object_asset": "1502568296128581632",
                    "object_grid": "1447853763061747712",
                    "slug": "Test",
                    "slug_highlight": "",
                    "source": "YouTube, Dec 8, 2025 at 8:33PM",
                    "source_highlight": "",
                    "source_id": "55524c204558544c0000019b006c244e",
                    "source_type": "YouTube",
                    "status": 2,
                    "timestamp_end": 1778283000000,
                    "timestamp_start": 1778281773118,
                    "update_timestamp": 1778281824416
                },
                "type": "source"
            }
        ],
        "size": 1,
        "total": 3
    }
}

Modified at 2026-06-05 02:45:34

Search persons globally by name or ID tags

Fetch all tags across objects