The Copyleaks AI Content Detection API returns a comprehensive response that includes classification results, probability scores, and detailed explanations of the AI detection analysis. This response structure provides both high-level insights and granular details about detected AI-generated content patterns.

Response Properties

modelVersion string

The version of the AI detection model used (e.g., “v9.0”).

results array<object>

An array of classification results for different sections of the text.

result array[object]

An array of all the classifications. The sections contain their position, classification and the probability for that classification.

classification integer

Indicates the text classification.

Available Options:

1 - Human 2 - AI Generated Text

probability number<float> deprecated

The classification confidence.

Caution

We plan to remove this value by July 2026.

matches array[object]

Provides information about the match objects that have been found in the text.

text object

Describes the text positions for the result (textual version).

chars object

Positions of the characters in that sepcific result.

starts array[integer]

Character match start positions.

lengths array[integer]

Character match lengths.

words object

Positions of the words in that sepcific result.

starts array[integer]

Words match start positions.

length array[integer]

Words match lengths.

html object

Describes the text positions for the result (html version).

Default: null

chars object

Positions of the characters in that sepcific result.

starts array[integer]

Character match start positions.

length array[integer]

Character match lengths.

groupIds array[integer]

Group identifiers associated with each word.

words object

Positions of the words in that sepcific result.

starts array[integer]

Words match start positions.

length array[integer]

Words match lengths.

groupIds array[integer]

Group identifiers associated with each word.

summary object

An object containing the overall proportion of human vs. AI-written content.

summary object

Aggregated detection results.

human number<float>

Indicates the confidence in which this text was written by a human.

ai number<float>

Indicates the confidence in which this text was written by AI.

scannedDocument object

Metadata about the scan.

scanId string

The unique scan id provided by you.

totalWords integer

Unsigned Integer

Total number of words found in the scanned text.

totalExcluded integer

Unsigned Integer

Number of excluded words in the submitted content.

credits integer

Overall credits used for the scan.

creationTime string<date-time>

The creation time of the scan.

Timezone: UTC+0

metadata object

finalUrl string<uri>

The submitted url after all http redirects.

canonicalUrl string<uri>

Extracted canonical url from the scanned document.

publishDate string<date-time>

Publication date of the scanned document.

creationDate string<date-time>

Creation date of the scanned document.

lastModificationDate string<date-time>

Last modification date of the scanned document.

author string

Scanned document author.

organization string

Scanned document organization.

filename string

Scanned document filename.

explain object

Data for the AI Logic feature, providing a detailed explanation of the detection patterns. This is only present when AI Logic is enabled in the request.

explain object beta

Example: {}

patterns object

statistics object

aiCount array[number]

The number of occurrences of AI-generated text patterns per 1 million texts.

humanCount array[number]

The number of occurrences of human-written text patterns per 1 million texts.

text object

chars object

starts array[number]

Start positions of character matches.

lengths array[number]

Lengths of the character matches.

words object

starts array[number]

Start positions of word matches.

lengths array[number]

Lengths of the word matches.

Example Response

{
  "modelVersion": "v9.0",
  "results": [
    {
      "classification": 2,
      "probability": 0.7316979,
      "matches": [
        {
          "text": {
            "chars": {
              "starts": [0],
              "lengths": [554]
            },
            "words": {
              "starts": [0],
              "lengths": [73]
            }
          }
        }
      ]
    }
  ],
  "summary": {
    "human": 0.0,
    "ai": 1.0
  },
  "scannedDocument": {
    "scanId": "scan-id",
    "totalWords": 73,
    "totalExcluded": 0,
    "actualCredits": 1,
    "expectedCredits": 1,
    "creationTime": "2025-08-10T08:33:05.22225Z"
  },
  "explain": {
    "patterns": {
      "statistics": {
        "aiCount": [1.2066389, 9.673915, 34.41001],
        "humanCount": [0.18481831, 0.13894142, 0.33555666],
        "proportion": [6.5287843, 69.625854, 102.54607],
        "source": [1, 1, 1]
      },
      "text": {
        "chars": {
          "starts": [10, 96, 136],
          "lengths": [25, 33, 33]
        },
        "words": {
          "starts": [1, 12, 17],
          "lengths": [4, 4, 5]
        }
      }
    }
  }
}

Classification Codes

Code	Classification	Description
0	Human	Content is likely written by a human
1	Mixed	Content contains both human-written and AI-generated segments
2	AI-generated	Content is likely generated by artificial intelligence

Next Steps

AI Content Detection Guide Learn how to use the AI Content Detection API to identify AI-generated text.

AI Detection API Reference Explore the complete API reference for AI content detection.

AI Logic Feature Understand how AI Logic provides transparency in AI detection results.