Search persons globally by name or ID tags

POST

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

Searches for named persons across all accessible groups and data sources. Accepts a free-text name query (e.g. 'John Smith') and/or a list of known person IDs as tag filters to narrow results. Unlike the group-scoped name search, this endpoint queries the global person index and returns matches from any group library accessible to the caller. Each result includes person profile metadata. Pagination via pageNum/pageSize. 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

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/globalnametag' \
--header 'SID: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "query": "ROBINSON",
    "size": 20,
    "userid": "shorvath@newsnationnow.com",
    "sessionid": "1C0C49E66DAC4CEE941EF70F77A94A9F",
    "tsrange": {
        "starttime": 1775684026048,
        "endtime": 1778276026048
    },
    "tags": {
        "personids": []
    },
    "permission": {
        "objectSources": [
            "1031568072126906368",
            "1031567701400764416"
        ],
        "enable": true
    }
}'

Response Example

200 - 成功示例

{
    "code": 0,
    "message": "succ",
    "data": {
        "host_person": {
            "name": ""
        },
        "list": [
            {
                "access": {
                    "peerlist": [
                        "FFFFFFF00001B200"
                    ]
                },
                "asset_num": 1,
                "face_num": 2,
                "group_id": "b7f47630d47c4479aff16b9e1862e77d",
                "name": "Amy Robinson",
                "path": "FFFFFFF00001B200_1721098514284.jpg",
                "peer_id": "FFFFFFF00001B200",
                "person_id": "1721098512007fkpmi32n",
                "position": {
                    "height": 167,
                    "left": 1330,
                    "top": 364,
                    "width": 124
                },
                "timestamp": 1721098514284
            },
            {
                "access": {
                    "peerlist": [
                        "FFFFFFF00001B203"
                    ]
                },
                "asset_num": 1,
                "face_num": 51,
                "group_id": "b7f47630d47c4479aff16b9e1862e77d",
                "name": "Eartha Robinson",
                "path": "FFFFFFF00001B203_1714742713669.jpg",
                "peer_id": "FFFFFFF00001B203",
                "person_id": "1714742710657872ut2gm",
                "position": {
                    "height": 183,
                    "left": 439,
                    "top": 144,
                    "width": 135
                },
                "timestamp": 1714742713669
            }
        ],
        "size": 4,
        "total": 4
    }
}

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

List persons detected in a media file by face recognition

Search media content by tags and free text