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.

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 coordinate-related attributes (latitude, time_zone, weather_code, state_name).

wd
string

Set to 1 to include the recent date of a survey transaction (d_date).

mm
string

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

csipqs
string

Set to 1 to include an IPQS fraud_score result.

df_details
string

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

sip
string

Controls whether the IP address is shown on the response.

vpt
string

Pass 'check' to test whether the request is via VPN (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).

Response

200 - application/json

Respondent fingerprint and survey duplication results.

Respondent
object
Surveys
object[]