The content similarity module is available for every endpoint.
For each endpoint, there is an additional module for content similarity. This is supported by the Summary, Creative, and Livestream API. This flag is to be added to the standard API requests. Please see other documentation for complete API setup and requirements. Additional costs apply if enabled.
Code Sample
You will see that include_similar and store_vectors are highlighted. To store the
current asset being requested, you will need to store_vectors= 'true'. If you just
want to see what content is similar, without including the current asset, you can use
the include_similar= 'true' in isolation.
curl -X POST 'https://vod2.netra-video.com/v73/summary' -H "Content-Type: application/json" -H "Authorization: Bearer ibcoXzqOVfsB7dcOUk7VIy375X0e4WrN" -d '{"title" : "test ", "description" : "test description", "callback_urls" : ["http://api.webhookinbox.com/i/VXSx2Z2t/in/"], "source_url" : " https://clips-media-aka.warnermediacdn.com/cnn/clips/2023-05/1177965-a24006810000478eabcd4ae97e593e88/mp4/cms3-CNN-exp-g7-big-questions-marc-stewart-live-051710aseg1-cnni-world-primary-272885-1177965-1920x1080_8000k.mp4", “include_similar”= true, “store_vectors”= true}'
Upon making a successful request you should receive an acknowledgment callback in the following format.
{
"code": 202,
"body": {
"request_id": "c160eb8a-1094-49d5-b1e7-0e9d4024de91"
}
}
Note: In the event of an error, the callback would include an error message with the appropriate HTTP error code (e.g., 4xx or 5xx) . A 2xx message indicates that the request was accepted successfully.
Callback JSON
The Netra callback JSON structure is below. What is of specific interest is the similar-videos field. This will rank the nearest video assets in association with the asset processed with the current request.
With the similar-videos field, you will find the other assets request ID, original source_url, and the score for similarity.
{
"url": "https://clips-media-aka.warnermediacdn.com/cnn/clips/2023-05/1177965-a24006810000478eabcd4ae97e593e88/mp4/cms3-CNN-exp-g7-big-questions-marc-stewart-live-051710aseg1-cnni-world-primary-272885-1177965-1920x1080_8000k.mp4",
"title": "",
"description": "",
"tags": "",
"duration": "00:01:10",
"content-type": "video",
"summary": {
"iab-categories": {
"News & Politics": {
"International News": 78,
"National News": 13,
"Disasters": 5,
"War & Conflict": 2
}
},
"safety": {
"risk": "Low",
"garm-categories": {},
"flagged-scenes": {}
},
"activities": {
"interviewing": 97
},
"objects": {
"Person": {
"Man": 86
},
"Electronics": {
"Television": 10
},
"House": {
"Countertop": 2
}
},
"emotions": {
"Fear": 29,
"Disgust": 23,
"Sadness": 20,
"Anger": 11,
"Trust": 5
},
"places": {
"Living Room": 95,
"Historical Place": 4
},
"affinities": {
"Political Junkies": 38,
"Family-Focused": 36,
"Green Living Enthusiasts": 13,
"Avid Investors": 8
}
},
"similar-videos": {
"6b78dc12-eb34-11ed-9be4-901b0ecc4ec5": {
"url": "https://clips-media-aka.warnermediacdn.com/cnn/clips/2022-03/678195-6a1c74e74f65431fa9ed9373a01c2e3a/mp4/cms3-CNN-ukraine-nuclear-plant-video-zaporizhzhia-tsr-vpx-primary-169458-678195-1920x1080_8000k.mp4",
"score": 67
},
"19e0c344-f613-11ed-871e-901b0ecc4ec5": {
"url": "https://clips-media-aka.warnermediacdn.com/cnn/clips/2023-05/1177965-a24006810000478eabcd4ae97e593e88/mp4/cms3-CNN-exp-g7-big-questions-marc-stewart-live-051710aseg1-cnni-world-primary-272885-1177965-1920x1080_8000k.mp4",
"score": 64
},
"52df9042-eb34-11ed-9be4-901b0ecc4ec5": {
"url": "https://clips-media-aka.warnermediacdn.com/cnn/clips/2022-03/679905-fadd2d8f2c0146878784f88b57f0e29b/mp4/cms3-CNN-let-it-go-frozen-kyiv-shelter-ukraine-ac360-wknd-sot-intl-ovn-vpx-primary-169726-679905-1920x1080_8000k.mp4",
"score": 64
},
"9d064dde-eb32-11ed-9be4-901b0ecc4ec5": {
"url": "https://clips-media-aka.warnermediacdn.com/cnn/clips/2022-05/760439-be93b43c65a04ddfa443744b7b5efc98/mp4/cms3-CNN-ukraine-steel-plant-mariupol-russia-explosions-ath-vpx-primary-183141-760439-1920x1080_8000k.mp4",
"score": 67
},
"0813cc0a-eb33-11ed-9be4-901b0ecc4ec5": {
"url": "https://clips-media-aka.warnermediacdn.com/cnn/clips/2022-04/741594-020a278f1f9c4a0a9cab8623845b97e6/mp4/cms3-CNN-shanghai-lockdown-footage-steven-jiang-intl-ldn-vpx-primary-179791-741593-1920x1080_8000k.mp4",
"score": 63
},
"2b1cd948-eb34-11ed-9be4-901b0ecc4ec5": {
"url": "https://clips-media-aka.warnermediacdn.com/cnn/clips/2022-03/691023-93322a39f46f4d2d8f027386a0600949/mp4/cms3-CNN-zelensky-message-russian-troops-ukraine-intl-ovn-sot-vpx-primary-171665-691023-1920x1080_8000k.mp4",
"score": 67
},
"0b9b4c2c-eb33-11ed-9be4-901b0ecc4ec5": {
"url": "https://clips-media-aka.warnermediacdn.com/cnn/clips/2022-04/741081-487eef6c7f1c4a63a6eafb97245cae6e/mp4/cms3-CNN-moskva-russian-warship-final-moments-phil-black-sot-tsr-vpx-primary-179714-741081-1920x1080_8000k.mp4",
"score": 68
},
"54930446-eb34-11ed-9be4-901b0ecc4ec5": {
"url": "https://clips-media-aka.warnermediacdn.com/cnn/clips/2022-03/679556-0299e0de2b2f49de9a6f7ca7b037af2a/mp4/cms3-CNN-irpin-ukraine-russian-missile-nrwknd-vpx-primary-169692-679556-1920x1080_8000k.mp4",
"score": 66
},
"24e0516a-eb32-11ed-9be4-901b0ecc4ec5": {
"url": "https://clips-media-aka.warnermediacdn.com/cnn/clips/2022-05/774078-2806e6570c51437bb6616cebaf859b51/mp4/cms3-CNN-russian-border-ukrainian-unit-melissa-bell-bts-nr-vpx-primary-185727-774071-1920x1080_8000k.mp4",
"score": 61
}
}
}