Skip to content

Writeprint detector output

Introduction

The Writeprint detector API resource returns a JSON object with this format:

{
    "success": Boolean success flag,
    "data": {
        "content": analyzed text,
        "language": language code,
        "version": technology version info,
        "knowledge": [],
        "paragraphs": [],
        "sentences": [],
        "phrases": [],
        "tokens": [],
        "entities": [],
        "extractions": [],
        "extraData": {}
    }
}

For the description of the contents, language and version properties, see the API resources output overview.

You can ignore all the arrays because they are simply functional to the production of the fundamental output that is inside the extradata object. If you are still interested, consider that the output arrays are the product of other API capabilities, so:

extraData object

The extraData object only property is JSON-LD, for example:

"extraData": {
    "JSON-LD": {
        "@context": {
            ...
        },
        "@graph": [
            {
                "@type": "https://schema.org/Thing",
                "readabilityIndexes": [
                    {
                        "@type": "https://schema.org/PropertyValue",
                        "name": "Coleman-Liau",
                        "value": 14.58,
                        "readabilityLevel": "Very Difficult"
                    },
                    {
                        "@type": "https://schema.org/PropertyValue",
                        "name": "Gulpease",
                        "value": 50.57,
                        "readabilityLevel": "Medium"
                    },
                    {
                        "@type": "https://schema.org/PropertyValue",
                        "name": "Automated Readability Index",
                        "value": 13.55,
                        "readabilityLevel": "Very Difficult"
                    }
                ],
                "structureIndexes": {
                    "sentences": {
                        "total": 11
                    },
                    "tokens": {
                        "total": 199
                    },
                    "tokenLengthPerSentence": {
                        "mean": 5.69,
                        "standardDeviation": 3.52,
                        "meanAbsoluteDeviation": 2.85
                    },
                    "verbTypes": {
                        "total": 9
                    },
                    "charactersPerSentence": {
                        "mean": 120.09,
                        "standardDeviation": 50.35,
                        "meanAbsoluteDeviation": 45.38,
                        "total": 1321
                    },
                    "atomsPerSentence": {
                        "mean": 20.63,
                        "standardDeviation": 8.94,
                        "meanAbsoluteDeviation": 7.9,
                        "total": 227
                    },
                    "tokensPerSentence": {
                        "mean": 18.09,
                        "standardDeviation": 7.05,
                        "meanAbsoluteDeviation": 6.29,
                        "total": 199
                    },
                    "phrasesPerSentence": {
                        "mean": 10.72,
                        "standardDeviation": 4.2,
                        "meanAbsoluteDeviation": 3.93,
                        "total": 118
                    },
                    "verbTypesPerSentence": {
                        "mean": 2.36,
                        "standardDeviation": 1.14,
                        "meanAbsoluteDeviation": 0.89,
                        "total": 9
                    },
                    "smallFirstLetterSentences": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "capitalFirstLetterSentences": {
                        "mean": 1,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 11
                    },
                    "adjectivesPerSentence": {
                        "mean": 1.54,
                        "standardDeviation": 1.23,
                        "meanAbsoluteDeviation": 1.04,
                        "total": 17
                    },
                    "adverbsPerSentence": {
                        "mean": 0.54,
                        "standardDeviation": 0.89,
                        "meanAbsoluteDeviation": 0.69,
                        "total": 6
                    },
                    "articlesPerSentence": {
                        "mean": 1.18,
                        "standardDeviation": 1.26,
                        "meanAbsoluteDeviation": 0.99,
                        "total": 13
                    },
                    "auxiliariesPerSentence": {
                        "mean": 0.9,
                        "standardDeviation": 0.79,
                        "meanAbsoluteDeviation": 0.66,
                        "total": 10
                    },
                    "conjunctionsPerSentence": {
                        "mean": 1.09,
                        "standardDeviation": 0.99,
                        "meanAbsoluteDeviation": 0.84,
                        "total": 12
                    },
                    "nounsPerSentence": {
                        "mean": 5.36,
                        "standardDeviation": 1.96,
                        "meanAbsoluteDeviation": 1.66,
                        "total": 59
                    },
                    "properNounsPerSentence": {
                        "mean": 0.72,
                        "standardDeviation": 0.86,
                        "meanAbsoluteDeviation": 0.66,
                        "total": 8
                    },
                    "punctuationPerSentence": {
                        "mean": 1.9,
                        "standardDeviation": 0.9,
                        "meanAbsoluteDeviation": 0.66,
                        "total": 21
                    },
                    "prepositionsPerSentence": {
                        "mean": 1.72,
                        "standardDeviation": 1.13,
                        "meanAbsoluteDeviation": 0.89,
                        "total": 19
                    },
                    "pronounsPerSentence": {
                        "mean": 0.36,
                        "standardDeviation": 0.64,
                        "meanAbsoluteDeviation": 0.52,
                        "total": 4
                    },
                    "particlesPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "verbsPerSentence": {
                        "mean": 2.72,
                        "standardDeviation": 1.05,
                        "meanAbsoluteDeviation": 0.92,
                        "total": 30
                    },
                    "namedEntitiesPerSentence": {
                        "mean": 0.81,
                        "standardDeviation": 1.11,
                        "meanAbsoluteDeviation": 0.74,
                        "total": 9
                    },
                    "adjectivePhrasesPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "conjunctionPhrasesPerSentence": {
                        "mean": 1,
                        "standardDeviation": 0.85,
                        "meanAbsoluteDeviation": 0.72,
                        "total": 11
                    },
                    "adverbPhrasesPerSentence": {
                        "mean": 0.18,
                        "standardDeviation": 0.38,
                        "meanAbsoluteDeviation": 0.29,
                        "total": 2
                    },
                    "nounPhrasesPerSentence": {
                        "mean": 3.09,
                        "standardDeviation": 1.23,
                        "meanAbsoluteDeviation": 1.02,
                        "total": 34
                    },
                    "nominalPredicatesPerSentence": {
                        "mean": 0.18,
                        "standardDeviation": 0.38,
                        "meanAbsoluteDeviation": 0.29,
                        "total": 2
                    },
                    "prepositionPhrasesPerSentence": {
                        "mean": 1.9,
                        "standardDeviation": 1.08,
                        "meanAbsoluteDeviation": 0.84,
                        "total": 21
                    },
                    "relativePhrasesPerSentence": {
                        "mean": 0.18,
                        "standardDeviation": 0.38,
                        "meanAbsoluteDeviation": 0.29,
                        "total": 2
                    },
                    "verbPhrasesPerSentence": {
                        "mean": 2.54,
                        "standardDeviation": 1.07,
                        "meanAbsoluteDeviation": 0.87,
                        "total": 28
                    },
                    "unknownConceptsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "emoticonsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "academicLanguageWordsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "businessLanguageWordsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "crimeLanguageWordsPerSentence": {
                        "mean": 0.36,
                        "standardDeviation": 0.48,
                        "meanAbsoluteDeviation": 0.46,
                        "total": 4
                    },
                    "laymanLanguageWordsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "legalLanguageWordsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "militaryLanguageWordsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "politicalLanguageWordsPerSentence": {
                        "mean": 1.27,
                        "standardDeviation": 1.6,
                        "meanAbsoluteDeviation": 1.3,
                        "total": 14
                    },
                    "socialMediaLanguageWordsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "colonsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "commasPerSentence": {
                        "mean": 0.63,
                        "standardDeviation": 0.88,
                        "meanAbsoluteDeviation": 0.69,
                        "total": 7
                    },
                    "dotsPerSentence": {
                        "mean": 1,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 11
                    },
                    "doubleQuotationMarksPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "exclamationMarksPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "exclamationMarkQuestionMarkSequencesPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "multipleDotsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "multipleExclamationMarksPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "multipleQuestionMarksPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "questionMarksPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "semicolonsPerSentence": {
                        "mean": 0.09,
                        "standardDeviation": 0.28,
                        "meanAbsoluteDeviation": 0.16,
                        "total": 1
                    },
                    "singleQuotationMarksPerSentence": {
                        "mean": 0.18,
                        "standardDeviation": 0.38,
                        "meanAbsoluteDeviation": 0.29,
                        "total": 2
                    },
                    "commonlyMisspelledWordsPerSentence": {
                        "mean": 0,
                        "standardDeviation": 0,
                        "meanAbsoluteDeviation": 0,
                        "total": 0
                    },
                    "functionWordsPerSentence": {
                        "mean": 6.45,
                        "standardDeviation": 3.75,
                        "meanAbsoluteDeviation": 2.85,
                        "total": 71
                    },
                    "mostCommonWordsPerSentence": {
                        "mean": 8.36,
                        "standardDeviation": 4.05,
                        "meanAbsoluteDeviation": 3.07,
                        "total": 92
                    }
                }
            }
        ]
    }
}

Writeprint information is contained in the JSON-LD property which, as the name suggests, is a JSON-LD object.
For the description of the JSON-LD format refer to the official documentation.

The @graph property of the JSON-LD object is an array which only item is an object containing the actual Writeprint information. The readabilityIndexes property is an array containing one item for each of the available readability indexes. The structureIndexes property is an object which properties represent the other 57 indexes.

The readabilityIndexes array

readabilityIndexes array items have these properties:

  • name: the readability index name, for example Coleman-Liau
  • value: the index value, for example 14.58
  • readabilityLevel: the degree of difficulty, with these possible values:
    • Very Easy
    • Easy
    • Medium
    • Difficult
    • Very Difficult

The structureIndexes object

All the properties of the structureIndexes object whose name ends with "PerSentence" except tokenLengthPerSentence are objects with these properties:

  • mean: the mean of all the values for all the sentences
  • standardDeviation: the standard deviation.
  • meanAbsoluteDeviation: the mean absolute deviation
  • total: the sum of the number of occurrences of items measured by the index for all the sentences in the document

The tokenLengthPerSentence object doesn't have the total property.

The remaining properties of the structureIndexes object, that is:

  • sentences
  • tokens
  • verbTypes

have only the total property.

Find the description of the indexes in the guide section.