PREDUPE (POST)

POST

predupes

PREDUPE (POST)

curl --request POST \
  --url https://prod.search.resdefio.com/predupes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "Destination": [
    {
      "Platform_Id": "<string>",
      "Survey_Numbers": [
        "2025_09"
      ]
    }
  ],
  "Panel_Id": "<string>",
  "Hashed_Email": "<string>",
  "Supplier_Id": "<string>",
  "Session_Id": "<string>"
}
'

import requests

url = "https://prod.search.resdefio.com/predupes"

payload = {
    "Destination": [
        {
            "Platform_Id": "<string>",
            "Survey_Numbers": ["2025_09"]
        }
    ],
    "Panel_Id": "<string>",
    "Hashed_Email": "<string>",
    "Supplier_Id": "<string>",
    "Session_Id": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    Destination: [{Platform_Id: '<string>', Survey_Numbers: ['2025_09']}],
    Panel_Id: '<string>',
    Hashed_Email: '<string>',
    Supplier_Id: '<string>',
    Session_Id: '<string>'
  })
};

fetch('https://prod.search.resdefio.com/predupes', 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.search.resdefio.com/predupes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'Destination' => [
        [
                'Platform_Id' => '<string>',
                'Survey_Numbers' => [
                                '2025_09'
                ]
        ]
    ],
    'Panel_Id' => '<string>',
    'Hashed_Email' => '<string>',
    'Supplier_Id' => '<string>',
    'Session_Id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://prod.search.resdefio.com/predupes"

	payload := strings.NewReader("{\n  \"Destination\": [\n    {\n      \"Platform_Id\": \"<string>\",\n      \"Survey_Numbers\": [\n        \"2025_09\"\n      ]\n    }\n  ],\n  \"Panel_Id\": \"<string>\",\n  \"Hashed_Email\": \"<string>\",\n  \"Supplier_Id\": \"<string>\",\n  \"Session_Id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://prod.search.resdefio.com/predupes")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"Destination\": [\n    {\n      \"Platform_Id\": \"<string>\",\n      \"Survey_Numbers\": [\n        \"2025_09\"\n      ]\n    }\n  ],\n  \"Panel_Id\": \"<string>\",\n  \"Hashed_Email\": \"<string>\",\n  \"Supplier_Id\": \"<string>\",\n  \"Session_Id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://prod.search.resdefio.com/predupes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"Destination\": [\n    {\n      \"Platform_Id\": \"<string>\",\n      \"Survey_Numbers\": [\n        \"2025_09\"\n      ]\n    }\n  ],\n  \"Panel_Id\": \"<string>\",\n  \"Hashed_Email\": \"<string>\",\n  \"Supplier_Id\": \"<string>\",\n  \"Session_Id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "Destination": [
    {
      "Platform_Name": "<string>",
      "Surveys": [
        {
          "Flag": 123,
          "Survey_Number": "<string>",
          "Duplicate_Initial_UD": "<string>",
          "Duplicate_Potential": "low",
          "Duplicate_Score": 123
        }
      ]
    }
  ],
  "Threat_Potential_Score": 123
}

Checks for duplicates across multiple survey numbers (projects) on destination platforms, using traffic from another client. This is the standalone PREDUPE API on prod.search.resdefio.com; it is read-only and does not record a survey number that isn’t already found.

Up to 30 survey numbers are processed per request across all destinations. If the total exceeds the limit, entries are processed randomly.
Send the request body as JSON with a Destination array. Each entry has the destination Platform_Id and its Survey_Numbers. Look up platform IDs with DESTINATION_PLATFORM.
Authenticate with the x-api-key header. Send the respondent’s IP address, cookie, and user agent in rd-ip-address, rd-cookie, and rd-user-agent.
Panel_Id, Hashed_Email, Supplier_Id, and Session_Id are optional. They replace rt_sr_pd, rt_hd_el, pm_sr_id, and sn_ud from SEARCH on rtymgt.com.

The GET variant takes the same body and returns the same result: PREDUPE (GET). See the Predupe Integration guide for a full browser sample. See the PREDUPE guide for the field definitions.

Authorizations

x-api-key

string

header

required

API key issued for the resdefio.com APIs.

Headers

rd-ip-address

string

The respondent's IP address.

The respondent's Research Defender cookie.

rd-user-agent

string

The respondent's browser user agent.

Body

application/json

Destination

object[]

required

Destination platforms and the survey numbers to check on each. A maximum of 30 survey numbers are processed per request; beyond that, entries are processed randomly.

Show child attributes

Panel_Id

string

Panelist ID. Optional. Formerly rt_sr_pd on SEARCH.

Hashed_Email

string

Hashed email. Optional. Formerly rt_hd_el on SEARCH.

Supplier_Id

string

Supplier ID, for reporting only. Optional. Formerly pm_sr_id on SEARCH.

Session_Id

string

Session ID that identifies the transaction. Optional. Formerly sn_ud on SEARCH.

Response

200 - application/json

Duplicate check results per destination platform.

Destination

object[]

Show child attributes

Threat_Potential_Score

integer

1 (lowest threat) to 99 (highest threat), derived from internal evaluation signals.

PREDUPE (POST)

curl --request POST \
  --url https://prod.search.resdefio.com/predupes \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "Destination": [
    {
      "Platform_Id": "<string>",
      "Survey_Numbers": [
        "2025_09"
      ]
    }
  ],
  "Panel_Id": "<string>",
  "Hashed_Email": "<string>",
  "Supplier_Id": "<string>",
  "Session_Id": "<string>"
}
'

import requests

url = "https://prod.search.resdefio.com/predupes"

payload = {
    "Destination": [
        {
            "Platform_Id": "<string>",
            "Survey_Numbers": ["2025_09"]
        }
    ],
    "Panel_Id": "<string>",
    "Hashed_Email": "<string>",
    "Supplier_Id": "<string>",
    "Session_Id": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    Destination: [{Platform_Id: '<string>', Survey_Numbers: ['2025_09']}],
    Panel_Id: '<string>',
    Hashed_Email: '<string>',
    Supplier_Id: '<string>',
    Session_Id: '<string>'
  })
};

fetch('https://prod.search.resdefio.com/predupes', 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.search.resdefio.com/predupes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'Destination' => [
        [
                'Platform_Id' => '<string>',
                'Survey_Numbers' => [
                                '2025_09'
                ]
        ]
    ],
    'Panel_Id' => '<string>',
    'Hashed_Email' => '<string>',
    'Supplier_Id' => '<string>',
    'Session_Id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://prod.search.resdefio.com/predupes"

	payload := strings.NewReader("{\n  \"Destination\": [\n    {\n      \"Platform_Id\": \"<string>\",\n      \"Survey_Numbers\": [\n        \"2025_09\"\n      ]\n    }\n  ],\n  \"Panel_Id\": \"<string>\",\n  \"Hashed_Email\": \"<string>\",\n  \"Supplier_Id\": \"<string>\",\n  \"Session_Id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://prod.search.resdefio.com/predupes")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"Destination\": [\n    {\n      \"Platform_Id\": \"<string>\",\n      \"Survey_Numbers\": [\n        \"2025_09\"\n      ]\n    }\n  ],\n  \"Panel_Id\": \"<string>\",\n  \"Hashed_Email\": \"<string>\",\n  \"Supplier_Id\": \"<string>\",\n  \"Session_Id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://prod.search.resdefio.com/predupes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"Destination\": [\n    {\n      \"Platform_Id\": \"<string>\",\n      \"Survey_Numbers\": [\n        \"2025_09\"\n      ]\n    }\n  ],\n  \"Panel_Id\": \"<string>\",\n  \"Hashed_Email\": \"<string>\",\n  \"Supplier_Id\": \"<string>\",\n  \"Session_Id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "Destination": [
    {
      "Platform_Name": "<string>",
      "Surveys": [
        {
          "Flag": 123,
          "Survey_Number": "<string>",
          "Duplicate_Initial_UD": "<string>",
          "Duplicate_Potential": "low",
          "Duplicate_Score": 123
        }
      ]
    }
  ],
  "Threat_Potential_Score": 123
}

LOOKUP

SEARCH

REVIEW

ACTIVITY

PREDUPE

ACTIVATION

GETTOKEN

Changelog

Authorizations

Headers

Body

Response