Skip to main content
GET
SEARCH
Digital fingerprinting with bot and click-farm detection. Returns a threat potential score, duplication scoring, and geolocation checks for a respondent at survey entry. sn_ud and sy_nr are required; rt_cy_ce (country code) is strongly recommended so SEARCH can detect country mismatches. Adding destination_platform_id and destination_platform_survey_number activates PREDUPE. For parameter definitions, failure-reason codes, the advanced fingerprinting JS library, and redundant-parameter guidance, see the SEARCH guide.

Path Parameters

publishable_key
string
required

Your Research Defender publishable key (client-side).

Query Parameters

sn_ud
string
required

Unique identifier for each API call (do not reuse across surveys/respondents). GUID recommended.

sy_nr
string
required

Unique identifier for the client survey, consistent for each survey.

rt_cy_ce
string

Survey country code (ISO 3166-1 alpha-2) so SEARCH can detect country mismatches. Recommended.

rt_sr_pd
string

Persistent respondent identifier for deduplication. Only use if you have independently verified respondent identity.

rt_hd_el
string

Hashed email, if any.

pm_sr_id
string

Supplier ID (name, abbreviation, or numeric) for backend reporting.

sy_gp_nr
string

Survey group identifier to deduplicate respondents across surveys.

set_window
integer

Lockout period in days for a survey. Returns days_flag=1 if the respondent attempted the survey within fewer days than this window.

coordinates
string

Set to 1 to include geolocation, time zone, and weather attributes (latitude, longitude, time_zone, weather_code, state_name).

wd
string

Set to 1 to include the last transaction date (d_date).

mm
string

Set to 1 to disable MaxMind termed-failure detection (failure_reason=18).

csedp3
string

Set to 1 to provide a result from the EDP score (EDP3 node).

df_details
string

Set to 1 to include an additional dataset with respondent information.

sip
string

Set to 1 to show the IP address on the API response.

sisp
string

Set to 1 to provide the ISP (Internet Service Provider).

dupe_details
string

Set to 1 to show the corresponding details for the duplicate (dupes_details).

mfr
string

Set to 1 to provide every triggered failure reason (multiple_failure_reason), not just one.

tbc
string

Set to 1 to allow testers to bypass checks. For testing only.

vpt
string

Pass 'check' to check VPN status (returns 1/0).

usage_type
string

Set to 1 to return usage type: consumer, corporate, or hosting.

validation
string

V4 only: SHA-256 of the request URL signed with your private key (Hashed Validation).

destination_platform_id
string

PREDUPE: unique identifier for the destination platform/buyer. Retrieve via the destination_platforms endpoint.

destination_platform_survey_number
string

PREDUPE: the destination platform's internal survey number (for Research Desk, use the ProjectUd).

encrypt
integer

Set to 1 to receive the JSON response wrapped in an AES-256-GCM encrypted blob ({"data": "<base64>"}).

Response

200 - application/json

Respondent fingerprint and survey duplication results.

Respondent
object
Surveys
object[]