List persons detected in a media file by face recognition

GET

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

Returns a paginated list of persons identified via face recognition within the specified media recording and time window. Identify the recording by 'ph_path' (required); optionally narrow to a specific TVU device using 'peerid'. Each result includes the person's ID, name, thumbnail, and detected timestamps. Sort options: sort=1 ranks persons by how frequently they appear (useful for recurrence scoring); sort=2 lists persons in the order they first appear as on-screen guests. Session ID required.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Header Params

Responses

🟢200

application/json

Successful response; check code field for logical results: 0=success, 1001=invalid request, 1002=invalid session, 1404=access denied

Bodyapplication/json

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://mma.tvunetworks.com/api/search/v1/i/click?userid=soffeeshu4%40tvu.com&sessionid=undefined&uid=05-FFFFFFF11015C601-0C206C452A419A78&ph_path=mp4%2FFFFFFFF00015C633%2F55524C204558544C0000018F6581E6E4%2F240530-05-37-41-157%2F2%2Frt.mpd&pathtype=mpd&peerid=FFFFFFF00015C633&starttime=1717055940297&endtime=1717059381397&pageNum=1&pageSize=999&sort=1' \
--header 'SID: ' \
--header 'Authorization: Bearer <token>'

Response Example

200 - 成功示例

{
    "code": 0,
    "message": "succ",
    "data": {
        "size": 1,
        "total": 1,
        "list": [
            {
                "name": "",
                "person_id": "1710142217249mbzk5zx0",
                "path": "FFFFFFF00015C633_1717048728819.jpg",
                "position": {
                    "height": 271,
                    "left": 1076,
                    "top": 118,
                    "width": 186
                },
                "peer_id": "FFFFFFF00015C633",
                "timestamp": 1717055943701,
                "face_num": 1,
                "last_update_ts": 1717055943701,
                "tslist": [
                    1717055943701
                ],
                "tracklist": [
                    [
                        1717055943701,
                        1717055944101
                    ]
                ],
                "group_id": "00fe20a2d2d84093b304f0d54d4bedda",
                "total_track_duration": 1000
            }
        ],
        "host_person": {
            "name": "",
            "total_track_duration": 0
        }
    }
}

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

Get AI summarization for a media segment

Search persons globally by name or ID tags