Cross-type media content search (v2)

POST

https://mma.tvunetworks.com/api/search/v2/search

Full-featured media content search across captions (STT transcripts), media assets, person detections, and source recordings. Authenticate via JWT Bearer token in the Authorization request header. When AI search is enabled, natural-language queries are automatically decomposed into person name filters and keyword matches. Time range defaults to the last 7 days when omitted. Results are scoped to the caller's access permissions. Use the 'dataSource' array to restrict which content types are searched ('caption', 'event', 'person', 'source'). Sort options include relevance score (0), creation time descending (1), creation time ascending (2), and custom field ordering.

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

🟢200OK

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://mma.tvunetworks.com/api/search/v2/search' \
--header 'SID: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "dataSource": [
        "event",
        "caption"
    ],
    "pageNum": 3,
    "pageSize": 10,
    "sort": 10,
    "timestampRange": {
        "startTimestamp": 1699545600000,
        "endTimestamp": 1762531199000
    },
    "filters": {
        "fuzzyMatchString": "books",
        "objectEvents": [],
        "objectSources": [
            "1398305490756308992"
        ],
        "persons": [],
        "tags": []
    },
    "userIds": [
        "578825562ca44818a40123ed90bc8ee2"
    ],
    "groupIds": [
        "16d219d093fe4d268a721bbce00d7de8"
    ],
    "searchLang": ""
}'

Response Example

{
    "errorCode": 0,
    "errorInfo": "succ",
    "result": {
        "size": 6,
        "list": [],
        "total": 6
    }
}

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

Search events by source object and time

Appearance search