Verity provides brand safety and contextual classification data for video platforms such as IRIS.TV and JW Player.
For the purposes of pre-bid targeting, a DSP can work directly with Verity to request existing video classification data.
Note: The DSP must be able to provide the unique persistent video identifier used by video platform (such as an IRIS_ID).
The integration works as follows:
The DSP provides Verity with the video platform’s unique video identifier.
Verity checks to see if the video has already been analyzed and classification data is available.
If data is available, Verity returns the video classification to the DSP.
Video Classification Endpoint
The Verity video analysis retrieval endpoint is:
GET /video/classification/{publisher_id}
Verity API processes HTTP GET requests for video classification data. The video is specified using the unique persistent identifier assigned by a video platform (such as an IRIS_ID).
Important: Support for this feature is made available via your Verity API Key. Contact verity-support@gumgum.com for more information.
Example Video Request
This example walks through retrieving classification data for a video available in the IRIS.TV Contextual Marketplace. The video’s publisher_ID
is an IRIS_ID of iris_12345.
Example GET Request
Submit a GET request to /video/classification/{publisher_ID}, for example:curl -X GET "https://verity-api.gumgum.com/video/classification/iris_12345" -H "accept: /" -H "x-api-key: <YOUR_API_KEY_HERE>"
Example JSON Response
If video classification data is available, the Verity API returns a JSON response with Content-Type: application/json; charset=UTF-8.
The data payload includes the JSON classification results detailing the complete brand safety, keyword, and categorization analysis data for the video. For example:
{ "uuid": "668e9d0e-a909-5ea0-9017-80c983a8db2c", "url": "https://vod-progressive.akamaized.net/exp=1621618638~acl=%2Fvimeo-prod-skyfire-std-us%2F01%2F3987%2F18%2F469935935%2F2090153996.mp4~hmac=a621155b76838fc3b5073dfdda3fbf730af5fd96d24bcbab3c25ee41dc023239/vimeo-prod-skyfire-std-us/01/3987/18/469935935/2090153996.mp4?download=1&filename=pexels-karolina-grabowska-5644289.mp4", "data": { "processedAt": "2021-05-21T16:47:35.352Z", "expiresAt": "2022-05-16T16:47:35.352Z", "languageCode": "en", "iab": { "v2": [ { "id": "52", "category": "Business and Finance", "score": 0.95 } ] }, "keywords": [ "black friday sale" ], "safe": true, "threats": [], "sentiments": [ { "sentiment": "neutral", "score": 1 }, { "sentiment": "negative", "score": 0 }, { "sentiment": "positive", "score": 0 } ] } }
See JSON Response for details about the fields included in the response.