SEARCH (GET)
curl --request GET \
--url https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}import requests
url = "https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}")
.asString();require 'uri'
require 'net/http'
url = URI("https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"Respondent": {
"threat_potential_score": "23",
"country": "United States",
"country_code": "US",
"respondent_risk": 0,
"respondent_ud": "4489560a-507f-468a-ae4b-d81ea80fab5d",
"time_zone": "America/Chicago"
},
"Surveys": [
{
"flag": 1,
"duplicate_initial_ud": "481cd5cf-88f1-44c2-8292-6b779b8a3a8e",
"duplicate_potential": "high",
"duplicate_score": "100",
"country_mismatch": 0,
"failure_reason": "02",
"days_flag": 1,
"days_difference": 0
}
]
}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.
Hashed email, if any.
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 geolocation, time zone, and weather attributes (latitude, longitude, time_zone, weather_code, state_name).
Set to 1 to include the last transaction date (d_date).
Set to 1 to disable MaxMind termed-failure detection (failure_reason=18).
Set to 1 to provide a result from the EDP score (EDP3 node).
Set to 1 to include an additional dataset with respondent information.
Set to 1 to show the IP address on the API response.
Set to 1 to provide the ISP (Internet Service Provider).
Set to 1 to show the corresponding details for the duplicate (dupes_details).
Set to 1 to provide every triggered failure reason (multiple_failure_reason), not just one.
Set to 1 to allow testers to bypass checks. For testing only.
Pass 'check' to check VPN status (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).
Set to 1 to receive the JSON response wrapped in an AES-256-GCM encrypted blob ({"data": "<base64>"}).
Was this page helpful?
curl --request GET \
--url https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}import requests
url = "https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}")
.asString();require 'uri'
require 'net/http'
url = URI("https://prod.rtymgt.com/api/v4/respondents/search/{publishable_key}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"Respondent": {
"threat_potential_score": "23",
"country": "United States",
"country_code": "US",
"respondent_risk": 0,
"respondent_ud": "4489560a-507f-468a-ae4b-d81ea80fab5d",
"time_zone": "America/Chicago"
},
"Surveys": [
{
"flag": 1,
"duplicate_initial_ud": "481cd5cf-88f1-44c2-8292-6b779b8a3a8e",
"duplicate_potential": "high",
"duplicate_score": "100",
"country_mismatch": 0,
"failure_reason": "02",
"days_flag": 1,
"days_difference": 0
}
]
}