SEARCH
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
Your Research Defender publishable key (client-side).
Query Parameters
Unique identifier for each API call (do not reuse across surveys/respondents). GUID recommended.
Unique identifier for the client survey, consistent for each survey.
Survey country code (ISO 3166-1 alpha-2) so SEARCH can detect country mismatches. Recommended.
Persistent respondent identifier for deduplication. Only use if you have independently verified respondent identity.
Supplier ID (name, abbreviation, or numeric) for backend reporting.
Survey group identifier to deduplicate respondents across surveys.
Lockout period in days for a survey. Returns days_flag=1 if the respondent attempted the survey within fewer days than this window.
Set to 1 to include coordinate-related attributes (latitude, time_zone, weather_code, state_name).
Set to 1 to include the recent date of a survey transaction (d_date).
Set to 0 to disable MaxMind termed-failure detection (failure_reason=18).
Set to 1 to include an IPQS fraud_score result.
Set to 1 to include an additional dataset with respondent information.
Controls whether the IP address is shown on the response.
Pass 'check' to test whether the request is via VPN (returns 1/0).
Set to 1 to return usage type: consumer, corporate, or hosting.
V4 only: SHA-256 of the request URL signed with your private key (Hashed Validation).
PREDUPE: unique identifier for the destination platform/buyer. Retrieve via the destination_platforms endpoint.
PREDUPE: the destination platform's internal survey number (for Research Desk, use the ProjectUd).