REVIEW

REVIEW provides text analysis of open-ended survey responses, producing a composite quality score along with copy/paste, profanity, engagement, language, and LLM-detection signals.

Core Functionality

Advanced text quality analysis using machine learning models
Copy/paste detection through behavioral monitoring and content analysis
Profanity and inappropriate content identification
Language detection and confidence scoring
Contextual relevance assessment against survey questions
AI-generated content detection (LLM identification)
Response engagement and effort measurement
Similarity detection across responses within the same question

Key Features

Composite Scoring: Combines multiple quality indicators into a single assessment score
Copy/Paste Detection: Identifies responses pasted from external sources
Contextual Analysis: Evaluates response relevance to the specific question asked
Language Intelligence: Supports multiple languages with confidence scoring
Behavioral Timing: Analyzes typing patterns and response completion time
LLM Detection: Identifies artificially generated responses from language models
Similarity Analysis: Detects duplicate or near-duplicate responses

JavaScript Integration

REVIEW includes specialized JavaScript libraries for:

Real-time copy/paste detection
Typing behavior analysis
Page interaction monitoring
Response timing measurement

The copy/paste and timestamp functionality requires the REVIEW library. See JavaScript Libraries and Enabling JavaScript Interaction Library below.

Typical Use Cases

Open-ended response quality validation
Detection of low-effort or copied responses
Profanity and content moderation
Multi-language survey response analysis
Academic and professional research quality assurance

Integration Options

Review Integration

Load the review library, collect timing and behavioral data, and send the respondent’s answer to REVIEW with GET or POST.

GET vs POST

GET
POST

There is a cap on the number of characters that can be sent on a GET call.

https://prod.rtymgt.com/api/v4/respondents/review/<publishable_key>?q_id=[%question-id%]&text=[%survey text%]&s_text_length=[%text length%]&question=[%question%]&c_text=[%pasted text%]&t_page_load=[%page load time%]&t_text_typed=[%typing start time%]&t_submit=[%submit time%]&p_fields=[%behavioral data%]&country_code=[%country code%]

POST allows a higher number of characters than GET.

POST https://prod.rtymgt.com/api/v4/respondents/review/<publishable_key>
Content-Type: application/json

{
  "q_id": "[%survey-question-id%]",
  "question": "[%question%]",
  "text": "[%survey text%]",
  "s_text_length": "[%text length%]",
  "c_text": "[%pasted text%]",
  "t_page_load": "[%page load time%]",
  "t_text_typed": "[%typing start time%]",
  "t_submit": "[%submit time%]",
  "p_fields": "[%behavioral data%]",
  "country_code": "[%country code%]"
}

Input Parameters

Required

Parameter	Data Type	Description
`q_id`	User-defined	Identifier for each survey question.
`text`	User-defined	Text entered by the respondent.
`sn_ud`	User-defined	Unique session identifier (GUID recommended).
`sy_nr`	User-defined	Unique identifier for the client survey.
`question`	Text	The survey question, which drives the contextual analysis.

Parameter	Data Type	Description
`c_text`	Text	Pasted text from the JS library, base64-encoded.
`s_text_length`	Text	Minimum number of characters needed to run the similarity check.
`t_page_load`	Float	Page-load time, base64-encoded.
`t_text_typed`	Float	Time when typing started, base64-encoded.
`t_submit`	Float	Time on submit, base64-encoded.
`p_fields`	Text	Behavioral data (keystrokes, mouse, and scroll) collected by the JS library. Used for `behavioral_tracking_*`, `programmatic_browsing`, `teleporting_mouse`, and `unnatural_scrolling`.
`country_code`	ISO 3166-1 alpha-2	Respondent country code, used for locale-based validation (`locale_mismatch`).

Recommended Response Parameters

Parameter	Data Type	Description
`composite_score`	Integer	Primary measure of response quality, combining copy/paste, profanity, engagement, language, and more. The individual inputs are also returned so you can build custom rules.
`similarity_text`	Integer	`1` if a duplicate open-end is detected (based on `s_text_length`).
`profanity_check`	Integer	`1` if profanity is detected, else `0`.
`model`	Object	Whether the response is contextually correct relative to the question, and whether it appears LLM-generated.

Additional Response Parameters

Score node

Parameter	Data Type	Description
`language_detected`	Text	Language used in the response (e.g. English, French).
`language_detected_score`	Float	Confidence interval (`.01` ≈ 99.9% confidence).
`profanity_check_score`	Float	Value based on the certainty with which profanity is used.
`pasted_response`	Integer	`1` if more than 90% of the text was pasted from the clipboard, else `0`.
`pasted_response_score`	Float	Share of the answer pasted from the clipboard (e.g. `0.4` = 40%).
`engagement_score`	Float	Response length relative to others for the same question ID (`1` = average, `<1` shorter, `>1` longer).
`page_view_time`	Float	Time from page load to submit (ms). Stand-alone; not part of the composite score.
`typed_response_time`	Float	Time from entering text to submit (ms). Stand-alone; not part of the composite score.
`programmatic_browsing`	Integer	Words-per-minute check from when the respondent started typing. Defaults to `0`; `1` if the speed passes a threshold, for example more than 200 wpm on a 20-word response, or 1200+ wpm.
`teleporting_mouse`	Integer	Mouse movement check. Defaults to `0`; `1` if cursor speed passes a threshold, or the cursor moves in a straight line.
`unnatural_scrolling`	Integer	Scroll check. Defaults to `0`; `1` if scroll speed passes a threshold, or the direction and speed are constantly fast.

Model node

Parameter	Data Type	Description
`rw_context_risk_score`	Integer	1 to 99. Risk that the response is contextually incorrect for the question.
`rw_context_risk_level`	Text	`low`, `medium`, or `high`.
`rw_context_description`	Text	`Yes, contextually correct` or `No, not contextually correct`.
`rw_llm_risk_score`	Integer	1 to 99. Risk that the response was produced by an AI.
`rw_llm_risk_level`	Text	`low`, `medium`, or `high`.
`rw_llm_description`	Text	Whether an LLM was detected, for example `LLM not detected`.
`locale_mismatch`	Integer	Locale-based validation of the response against the `country_code` you sent.
`behavioral_tracking_risk_score`	Integer	1 to 99. Risk based on the respondent’s keystroke and mouse interaction.
`behavioral_tracking_risk_level`	Text	`low`, `medium`, or `high`.
`behavioral_tracking_description`	Text	`Interaction is Natural` or `Interaction is Unnatural`.

Input node

Echoes the request: q_id, text, sn_ud, sy_nr, question, country_code, and similarity_text_length (the s_text_length value sent).

Response Example

{
  "model": {
    "rw_context_risk_score": 12,
    "rw_context_risk_level": "low",
    "rw_context_description": "Yes, contextually correct",
    "rw_llm_risk_score": 1,
    "rw_llm_risk_level": "low",
    "rw_llm_description": "LLM not detected"
  },
  "input": {
    "sy_nr": "test",
    "q_id": "3333",
    "question": "How satisfied are you with the current product features?",
    "sn_ud": "T_test",
    "text": "I am very satisfied because the features meet all my needs.",
    "similarity_text_length": "50"
  },
  "score": {
    "composite_score": 0,
    "similarity_text": 1,
    "profanity_check": 0,
    "engagement_score": 1,
    "language_detected": "English",
    "language_detected_score": 0.01,
    "pasted_response_score": 0,
    "page_view_time": 0,
    "typed_response_time": 0,
    "pasted_response": 0
  }
}

See the REVIEW endpoint reference for the full parameter list and a live playground.

Enabling JavaScript Interaction Library

The copy/paste and timestamp functionality requires the REVIEW JS library. Include it on the page header:

<script src="https://prod.rtymgt.com/static/js/review/sc_review_lib_secured_v1-3.min.js" type="text/javascript"></script>

Then initialize scReviewLib with your environment, publishable key, an element-ID object, and the four listeners (pageLoadListener, copyPasteListener, textEventListener, submitEventListener):

window.onload = function () {
  var objElement = {
    textElementId               : '[text_element_id]',
    pastedTextElementId         : '[encoded_pasted_text_element_id]',
    pageLoadTextTimeElementId   : '[encoded_page_load_time_text_element_id]',
    entryStartTextTimeElementId : '[encoded_typed_time_text_element_id]',
    submitTextTimeElementId     : '[encoded_submit_time_text_element_id]',
    submitButtonElementId       : '[submit_button_id]'
  };

  try {
    new scReviewLib(
      'https://prod.rtymgt.com', // [server]
      '[publishable_key]',       // client's publishable key
      objElement,
      pageLoadListener,
      copyPasteListener,
      textEventListener,
      submitEventListener
    );
  } catch (e) {
    document.write(e);
  }
};

REVIEW’s supported languages are listed in the REVIEW Supported Languages reference.

SEARCH

ACTIVITY

PREDUPE

ACTIVATION

Getting Started

REVIEW

Core Functionality

Key Features

JavaScript Integration

Typical Use Cases

Integration Options

Review Integration

GET vs POST

Input Parameters

Required

Recommended

Recommended Response Parameters

Additional Response Parameters

Score node

Model node

Input node

Response Example

Enabling JavaScript Interaction Library

​Core Functionality

​Key Features

​JavaScript Integration

​Typical Use Cases

​Integration Options

Review Integration

​GET vs POST

​Input Parameters

​Required

​Recommended

​Recommended Response Parameters

​Additional Response Parameters

​Score node

​Model node

​Input node

​Response Example

​Enabling JavaScript Interaction Library

Core Functionality

Key Features

JavaScript Integration

Typical Use Cases

Integration Options

GET vs POST

Input Parameters

Required

Recommended

Recommended Response Parameters

Additional Response Parameters

Score node

Model node

Input node

Response Example

Enabling JavaScript Interaction Library