Description: This API checks for the Open-Ended (OE) survey responses to ensure data quality. It performs language comparison, AI-generated answer detection, exclusion list checks, and response deduplication.
PureText Deduplication: Ensures the OE response is unique through deduplication.
Language Mismatch: Compares the language of the OE answer response with the survey language determined from the transaction ID.
AI Detection: Detects patterns to flag if the answer OE response is AI-generated content.
Incoherent Response: Flags any the obviously unacceptable responses such as gibberish, curse words, etc.
PureText
...
PureText should only be can be effectively used:
For expected responses with at least one meaningful sentence (not unlike categorical responses such as brand names, people and place names, slang, etc)
Expected responses are in the same language as survey language (For example, if the survey is in French, response should be only in French)
The API call can be utilized made in two ways:
Individual response: after every open-ended question
...
, or
Bulk processing: at the end of the survey for
...
ALL open-ended
...
responses
In either case, the API response shows you the result for each answer separately.
ATTN: Max. number of Please note: Upto 20 open-ended answers responses that can be processed is 20in bulk at a time.
Request
POST $apihost/$basepath/v3/transactions/ps_api_fail
($apihost is the environment against which you are testing, $basepath is the base path with the api version. All Buy API calls will require access-token parameter in the header.)
Parameters for 1
...
OE response:
Body:
| Code Block | ||
|---|---|---|
| ||
{
"transaction_id": "4mWpY50Z5ZpovKkXjt7Liw",
"questions": [
{
"question_id": alpha numeric,
"text": "string"
}
]
} |
...
| Code Block | ||
|---|---|---|
| ||
{
"transaction_id": "4mWpY50Z5ZpovKkXjt7Liw",
"data": [
{
"puretext_api_fail": 0,
"ai_generated_response": 0,
"incoherent_response": 0,
"duplicate_response": 0,
"language_mismatch": 0,
"question_id": “alpha numeric”
}
]
} |
Parameters for 2+
...
OE responses:
Body:
| Code Block | ||
|---|---|---|
| ||
{
"transaction_id": "4mWpY50Z5ZpovKkXjt7Liw",
"questions": [
{
"question_id": alpha numeric,
"text": "string"
},
{
"question_id": alpha numeric,
"text": "string"
}
]
} |
...
When processing "transaction_id": "4mWpY50Z5ZpovKkXjt7Liw" we found a duplicate answer which was first stated by "original_transaction_id": 3rWnTCAisTABjZEa2P3ZMF.
Example which processes 2
...
OE responses:
POST https://spectrumsurveys.com/buyers/v3/transactions/ps_api_fail
...