Table of Contents |
---|
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.
Important: To enable support for this feature, the DSP must contact verity-support@gumgum.com.
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/{publisherId}
Verity API processes HTTP GET requests for video classification data. The video is identified by a publisherId
, which is a unique persistent identifier assigned by a video platform (such as an IRIS_ID).
Example Video Request
This example walks through retrieving classification data for a video available in the IRIS.TV Contextual Marketplace. The video’s publisherId
is an IRIS_ID of iris_12345.
Example GET Request
Submit a GET request to /video/classification/{publisherId}, for example:curl -X GET "https://verity-api.gumgum.com/video/classification/iris_12345" -H "accept: /" -H "x-api-key: <YOUR_API_KEY_HERE>"
Note: The API Key you specify must include support for this feature.
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:
Code Block | ||
---|---|---|
| ||
{ "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 more details about the fields included in the response.