POST
/
moderate
/
video
Analyze video
curl --request POST \
  --url https://moderationapi.com/api/v1/moderate/video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contentId": "<string>",
  "doNotStore": true,
  "authorId": "<string>",
  "contextId": "<string>",
  "metadata": {},
  "url": "<string>"
}'
{
  "status": "<string>",
  "error": "<any>",
  "contentId": "<string>",
  "request": {
    "timestamp": 123,
    "quota_usage": 123
  },
  "flagged": true,
  "author": {
    "id": "<string>",
    "external_id": "<string>",
    "block": {
      "until": 123,
      "reason": "<string>"
    },
    "status": "enabled",
    "trust_level": {
      "level": 123,
      "manual": true
    }
  }
}
Video moderation needs to be enabled for accounts to use this endpoint. Please contact your support@moderationapi.com to talk about enabling this feature.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Input parameters for video moderation

url
string<uri>
required

The URL of the video you want to analyze.

contentId
string

The unique ID of the content in your database.

Required string length: 1 - 100
doNotStore
boolean

Do not store the content. The content won't enter the review queue

authorId
string

The author of the content.

contextId
string

For example the ID of a chat room or a post

metadata
object

Any metadata you want to store with the content

Response

Successful response

status
string
required

Success if the request was successful

request
object
required

Information about the request

flagged
boolean
required

Whether the content was flagged by any models

author
object | null
required

The author of the content if your account has authors enabled. Requires you to send authorId when submitting content.

error
any

Error message if the request failed

contentId
string

The ID of the content. Only returned if the content was stored.