/batch/analyzeAnalyze up to 1,000 samples in one request. Each utterance needs index, speaker (child or examiner) and text. The fields morphemes, morphemeCount, wordCount, isGrammatical and errors must be present; every count is made again from the text. An optional metadata object (for example a group column) is kept with each item.
Request
{
"items": [
{ "itemId": "s1", "label": "Pre-test", "ageMonths": 48,
"metadata": { "group": "A" },
"utterances": [
{ "index": 0, "speaker": "child", "text": "the dog runs",
"morphemes": [], "morphemeCount": 0, "wordCount": 0,
"isGrammatical": true, "errors": [] },
...
] },
{ "itemId": "s2", "label": "Post-test", "ageMonths": 60,
"metadata": { "group": "A" }, "utterances": [ ... ] }
]
}Response
{
"summary": { "total": 2, "succeeded": 2, "failed": 0,
"meanMluMorphemes": 7.75, "meanTtr": 0.8875, "errors": [],
"cohorts": [ { "group": "A", "n": 2, "meanMluMorphemes": 7.75, ... } ] },
"items": [
{ "itemId": "s1", "label": "Pre-test", "ageMonths": 48, "metadata": { "group": "A" },
"metrics": { "mluMorphemes": 4.5, "mluWords": 4.0, "ttr": 0.875, "ndw": 7, ... },
"advanced": { "dss": ..., "ipsyn": ..., ... },
"normative": { "status": "within", "expectedRange": [3.81, 5.33], "zScore": -0.09,
"ageBand": "4;0 to 4;5", "sampleSize": 49, "source": "Rice et al. (2010)", ... },
"error": null },
...
]
}