Skip to main content
POST
/
v012
Detailed survey response analysis for v012
curl --request POST \
  --url https://api.roundtable.ai/alias/v012 \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api_key>' \
  --data '
{
  "participant_id": "participant_123",
  "questions": {
    "Q1": "How do you feel our product has impacted your daily workflow?"
  },
  "responses": {
    "Q1": "I really like pineapple on pizza."
  },
  "survey_id": "survey_456",
  "question_histories": {
    "Q1": []
  }
}
'
{
  "error": false,
  "flagged": true,
  "model": "alias-v012",
  "num_checks_failed": 1,
  "checks": [
    "Automated test: Junk"
  ],
  "response_groups": {},
  "warning": "<string>"
}

Headers

​
api_key
string
required

API key for authentication. Include this in the header of your request.

Body

application/json
​
participant_id
string
required

A unique identifier for the participant.

Example:

"participant_123"

​
questions
object
required

Contains the survey questions. Each key is the id of the question, and the values are the text of the open-ended survey questions as shown to the participant.

Example:
{
  "Q1": "How do you feel our product has impacted your daily workflow?"
}
​
responses
object
required

Records the participant's final responses to each question.

Example:
{ "Q1": "I really like pineapple on pizza." }
​
survey_id
string
required

A unique identifier for the survey.

Example:

"survey_456"

​
question_histories
object

Records the changes made by the participant while answering the survey. Each key is the id of the question, and the value is the array of changes generated by our Javascript tracker.

Example:
{ "Q1": [] }

Response

200 - application/json

Analysis result for v012

​
error
boolean
default:false

Indicates if there was an error in processing the request.

​
flagged
boolean

Indicates if any fraudulent activity was detected. If true, we recommend reviewing the participant's responses.

​
model
string

String specifying the model type.

Example:

"alias-v012"

​
num_checks_failed
integer

Number of checks that failed.

Example:

1

​
checks
object

Details of specific checks and their outcomes. Available options include:

  • "All responses empty" - The participant didn't answer any question.
  • "Text chunking" - Some text was generated in a chunk (rather than character-by-character).
  • "GPT paste artifacts" - Text is formatted in a highly similar way to ChatGPT.
  • "Self-duplicate response" - The participant gave the same answer to more than one question.
  • "Cross-duplicate response" - The participant gave the same answer as another participant (excluding simple answers like 'Yes' or 'No').
  • "Unnatural typing speed" - The participant typed abnormally fast or slow.
  • "Unnatural pausing" - The participant paused in a way that is common to GPTs but not to humans.
  • "Automated test: Junk" - Our ML model flags this response as likely junk.
  • "Automated test: GPT" - Our ML model flags this response as likely generated by a GPT.
Example:
["Automated test: Junk"]
​
response_groups
object

Dictionary where key corresponds to question_id and value corresponds to the cluster of duplicated responses.

​
warning
string

A message that provides additional context or information about potential issues detected during the request processing. Only returned if there is a warning.