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": {}
}
}
Tip
Use the live demo to see how API responses look like. Run an analysis then select the {...} json tab in the results page.
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:
-
For
knowledge
see the description of full analysis output. -
For:
paragraphs
sentences
phrases
tokens
see the description of deep linguistic analysis output.
-
For
entities
see the description of named entity recognition output.
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-Liauvalue
: the index value, for example 14.58readabilityLevel
: 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 sentencesstandardDeviation
: the standard deviation.meanAbsoluteDeviation
: the mean absolute deviationtotal
: 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.