ITEMS_CHARACTERISTICS

Retrieve the results of a queued Items & Characteristics classification

This endpoint returns the results of a previously queued classify job.

The response for each item is a prevalence score between 0 and 1 that represents how present it is in the content. 1 is highest prevalence and 0 is lowest prevalence.

You can use these scores in mappings or models to implement safety policies, for example setting a numerical threshold for automated flagging of content or in a linear regression model.

Note that the score meaning and distribution is different for each item: for example, a 0.7 for pepe won’t translate to the same likelihood of harmful content as a 0.7 for confederate flag. Therefore you should calculate an individual threshold for each item. For best performance, we suggest calculating a threshold using labelled data, optimising for the balance of precision and recall best suited to your needs. The Unitary team is happy to provide guidance on this process.

get/classify/items-characteristics/image/{job_id}

Path parameters

job_idstring uuid4 required

Response

Successful Response

Example response

{
  "results": {
    "violence": {
      "violence": 0.54324,
      "firearm": 0.54324,
      "knife": 0.54324,
      "violent_knife": 0.54324
    },
    "substances": {
      "alcohol": 0.54324,
      "drink": 0.54324,
      "smoking_and_tobacco": 0.54324,
      "marijuana": 0.54324,
      "pills": 0.54324,
      "recreational_pills": 0.54324
    },
    "nsfw": {
      "adult_content": 0.54324,
      "suggestive": 0.54324,
      "adult_toys": 0.54324,
      "medical": 0.54324,
      "over_18": 0.54324,
      "exposed_anus": 0.54324,
      "exposed_armpits": 0.54324,
      "exposed_belly": 0.54324,
      "covered_belly": 0.54324,
      "covered_buttocks": 0.54324,
      "exposed_buttocks": 0.54324,
      "covered_feet": 0.54324,
      "exposed_feet": 0.54324,
      "covered_breast_f": 0.54324,
      "exposed_breast_f": 0.54324,
      "covered_genitalia_f": 0.54324,
      "exposed_genitalia_f": 0.54324,
      "exposed_breast_m": 0.54324,
      "exposed_genitalia_m": 0.54324
    },
    "hate_symbols": {
      "confederate_flag": 0.54324,
      "pepe_frog": 0.54324,
      "nazi_swastika": 0.54324
    },
    "ocr_language_toxicity": {
      "toxicity": 0.54324,
      "severe_toxicity": 0.54324,
      "obscene": 0.54324,
      "insult": 0.54324,
      "identity_attack": 0.54324,
      "threat": 0.54324,
      "sexual_explicit": 0.54324
    },
    "audio_language_toxicity": {
      "toxicity": 0.54324,
      "severe_toxicity": 0.54324,
      "obscene": 0.54324,
      "insult": 0.54324,
      "identity_attack": 0.54324,
      "threat": 0.54324,
      "sexual_explicit": 0.54324
    },
    "caption_language_toxicity": {
      "toxicity": 0.54324,
      "severe_toxicity": 0.54324,
      "obscene": 0.54324,
      "insult": 0.54324,
      "identity_attack": 0.54324,
      "threat": 0.54324,
      "sexual_explicit": 0.54324
    },
    "visual_content": {
      "artistic": 0.54324,
      "comic": 0.54324,
      "meme": 0.54324,
      "screenshot": 0.54324,
      "map": 0.54324,
      "poster_cover": 0.54324,
      "game_screenshot": 0.54324,
      "face_filter": 0.54324,
      "promo_info_graphic": 0.54324,
      "photo": 0.54324
    },
    "other": {
      "child": 0.54324,
      "middle_finger_gesture": 0.54324,
      "toy": 0.54324,
      "gambling_machine": 0.54324,
      "face_f": 0.54324,
      "face_m": 0.54324
    }
  }
}

Changes

Changed in 1 of the 2 revisions of this API.262

Sep 1, 2026e649db8f5cc8262See the full diff
- ▲
  the anyOf[subschema #1: AsyncResponse[ItemsCharacteristicsResponse]]/status response's property type/format changed from / to string/ for status 200
  response-property-type-changed
- ▲
  the anyOf[subschema #2: AsyncResponse[ErrorResponse]]/status response's property type/format changed from / to string/ for status 200
  response-property-type-changed
- ●
  added the new done enum value to the anyOf[subschema #1: AsyncResponse[ItemsCharacteristicsResponse]]/status response property for the response status 200
  response-property-enum-value-added
- ●
  added the new done enum value to the anyOf[subschema #2: AsyncResponse[ErrorResponse]]/status response property for the response status 200
  response-property-enum-value-added
- ●
  added the new failed enum value to the anyOf[subschema #1: AsyncResponse[ItemsCharacteristicsResponse]]/status response property for the response status 200
  response-property-enum-value-added
- ●
  added the new failed enum value to the anyOf[subschema #2: AsyncResponse[ErrorResponse]]/status response property for the response status 200
  response-property-enum-value-added
- ●
  added the new queued enum value to the anyOf[subschema #1: AsyncResponse[ItemsCharacteristicsResponse]]/status response property for the response status 200
  response-property-enum-value-added
- ●
  added the new queued enum value to the anyOf[subschema #2: AsyncResponse[ErrorResponse]]/status response property for the response status 200
  response-property-enum-value-added
- ○
  removed AsyncResponseStatus from the anyOf[subschema #1: AsyncResponse[ItemsCharacteristicsResponse]]/status response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed AsyncResponseStatus from the anyOf[subschema #2: AsyncResponse[ErrorResponse]]/status response property allOf list for the response status 200
  response-property-all-of-removed

Full history