Overview
An overview of the speech assessment API, its capabilities and integration workflow
The speech assessment API (SAAPI for short) returns a detailed speech report for a recording of English speech.
The API has three main versions:
- Pronunciation: reading (prompted) assessment of spoken English for pronunciation only.
- Scripted: reading (prompted) assessment of spoken English for pronunciation and reading fluency.
- Unscripted: speaking (spontaneous) assessment of spoken English where the response is unknown
Pronunciation & Scripted API
Integration workflow
For a scripted API request, you send us a recording of one of your users speaking + the expected text. Our API returns a detailed report with scores, metrics and feedback which you can then use to display back to your users via your own UI front-end.

Unscripted API
Integration workflow
For an unscripted API request, you only send us the recording of one of your users speaking since the content they may speak is open-ended and unscripted. Our API returns a detailed report with scores, metrics and feedback which you can then use to display back to your users via your own UI front-end.

Comparison of features
| Feature | Description | Pronunciation | Scripted API | Unscripted API |
|---|---|---|---|---|
| Pronunciation scoring | Returns a pronunciation report with scores at the phoneme, word and overall level | ✅ | ✅ | ✅ |
| Fluency scoring | Returns a fluency report with score, metrics and feedback | ✅ | ✅ | |
| Reading Assessment Metrics | Returns reading metrics | ✅ | ||
| Return predicted text | Returns the predicted text detected by the speech recognition | ✅ | ✅ | |
| Scripted content relevance | Returns how close the user's speech was to the expected content | ✅ | ||
| Unscripted content relevance | Returns how relevant the users answer was to the question asked. | ✅ | ||
| Grammar scoring | Returns a grammar report with score, metrics and feedback | ✅ | ||
| Vocabulary scoring | Returns a vocabulary report with score, metrics and feedback | ✅ | ||
| English test scoring estimates | Returns estimated predictions for IELTS, PTE and CEFR | ✅ | ✅ | ✅ |