Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Verity video analysis endpoints are:

...

languagejava

POST

...

/video/classification

Verity API processes HTTP POST requests to initiate a new video analysis.

...

...

GET

...

/video/classification/{uuid}

Verity API processes HTTP GET requests to return processed results.

...

languagejava

GET

...

/video/classification/{uuid}/status

Verity API processes HTTP GET requests to return the status of the video analysis.

Example Video Request

This example shows a request to analyze an english language video at the URL:

...

languagejava

http://content.jwplatform.com/videos/00D9qbqJ-320.mp4

Table of Contents

Step 1 – Submit a POST video classification request  

To start the video analysis, submit a POST request via curl to /video/classification. Include the required language code parameter:

Code Block

languagejs
curl -H 'x-api-key: <YOUR_API_KEY_HERE>' -X POST -d '{"url":"http://content.jwplatform.com/videos/00D9qbqJ-320.mp4", "languageCode": "en"}'  https://verity-api.gumgum.com/video/classification

Note: The url specified in the body must meet the following requirements:

...

Submit a GET request to /video/classification/{uuid}, specifying the uuid returned in the response in step 1. Once the status changes to PROCESSED, the JSON page classification results are returned in the data payload. For example:

...

languagejs

curl

...

-H

...

'x-api-key:

...

<YOUR_API_KEY_HERE>'

...

https://verity-api.gumgum.com/video/classification/123e4567-e89b-12d3-a456-426655440000

The JSON response details the complete brand safety, keyword, and categorization analysis data for the video.  See JSON Response for details about the fields included in the response.

...