Moderation Result Query

Update:

Request Specification

  • Request URL:

https://msafe.ilivedata.com/api/v1/media/web/result

  • API description:

This API is used to query the result of a web moderation task by taskId.

  • HTTP request Header:
Header Example value Required Description
Content-Type application/json;charset=UTF-8 Required Request body format. This API only accepts JSON request bodies
Accept application/json;charset=UTF-8 Optional Expected response format. JSON is returned by default if this header is not specified
X-AppId 82100001 Required The unique project identifier. You can get it from <Console - Service Configuration>
X-TimeStamp 2026-01-31T07:59:03Z Required The UTC time when the request is sent. The format is yyyy-MM-dd'T'HH:mm:ss'Z', for example: 2026-01-31T23:59:59Z
Authorization ***** Required Request signawture. See the “Request Signature” section below
  • Request method:

POST

  • Request body JSON:
Parameter Required Type Description
taskId Required String The task ID returned by the web moderation task submission API
  • Request body example:
{
  "taskId": "task_**************************"
}

Request Signature

This API requires the Authorization signature in the request Header. For the signature calculation rule, see Request Signature.

HTTP Response

Content-Type: application/json;charset=UTF-8

The result is in JSON format. See the following example.

  • Response JSON field description:
Field name Type Description
errorCode Number Error code. 0 means success
errorMessage String Error message
code Number Task status code: 0 completed, 1 failed, 2 processing, 3 invalid taskId
taskId String Unique identifier of the task
appId String Project identifier
inputType String Input type. Web moderation returns WEB
result Number Page-level moderation result: 0 pass, 1 suspected, 2 block
items Array Moderation results of parsed page items

items:

Field name Type Description
itemId String Unique identifier of the parsed item
mediaType String Media type: TEXT, IMAGE, AUDIO, or VIDEO
taskId String Provider task ID for asynchronous media items. This field may be empty for sync items
sourceUrl String Source URL of an image, audio, or video item
originalText String Original text content. Returned for text items
filteredText String Filtered text content. Returned when a text item hits blocking content
result Number Item-level moderation result: 0 pass, 1 suspected, 2 block
tags Array Hit category information

tags:

Field name Type Description
tag Number First-level category code. For details, see the classification code tables in Help Center
subTags Array Second-level category information

subTags:

Field name Type Description
subTag Number Second-level category code
  • Response example:
{
  "errorCode": 0,
  "code": 0,
  "taskId": "task_**************************",
  "appId": "82100001",
  "inputType": "WEB",
  "result": 2,
  "items": [
    {
      "itemId": "text_1",
      "mediaType": "TEXT",
      "originalText": "Example page text",
      "filteredText": "Example **** text",
      "result": 2,
      "tags": [
        {
          "tag": 150,
          "subTags": [
            {
              "subTag": 150001
            }
          ]
        }
      ]
    },
    {
      "itemId": "image_1",
      "mediaType": "IMAGE",
      "sourceUrl": "https://example.com/image.jpg",
      "result": 0
    }
  ]
}

If the task is still being processed, the response returns code: 2 and may include partial results when available. If the taskId does not exist, the response returns code: 3.

Error Code

HTTP status code Error code Error message Cause
200 0 This field is omitted Request succeeded
400 1003 Bad Request The request body is not valid JSON, or the service failed to process the request
400 1112 The project is closed now, please contact us to restart the project. The project is closed
400 2000 Missing Parameter Missing taskId
400 2001 Invalid Parameter Invalid parameter format
401 1102 Unauthorized Client Invalid X-AppId
401 1106 Missing Access Token Missing Authorization
401 1107 Invalid Token Incorrect Authorization signature
401 1108 Expired Token X-TimeStamp has expired
401 1110 Invalid Client Missing X-AppId
401 2000 Missing Parameter Missing X-TimeStamp
401 2001 Invalid Parameter Invalid X-TimeStamp format
429 - - Request rate limit exceeded