Security & Authentication

The Surveys Pull and Profilers endpoints use API key to allow access. You can obtain your API key from our representatives. [Link to contact details needed]

To access the APIs, include the API key in the HTTP Header of your HTTP request:

X-YourSurveys-Api-Key: yourapisecret

Examples

📘

Please note!

You must replace yourapisecret in the examples with your actual API key provided by Cint

Python

import requests
import json

url = 'https://www.your-surveys.com/suppliers_api/surveys/user'

headers = {
    'X-YourSurveys-Api-Key': 'yourapisecret'
}
request_params = {
  ...
}

response = requests.get(
    url,
    headers=headers,
    params=request_params,
)

PHP

<?php
$secret = 'yourapisecret';
# Required parameters
$params = array(
    'user_id'=> 12,
    'date_of_birth'=> '1990-01-01',
    'email'=> '[e-mail]',
    'gender'=> 'f',
    'zip_code'=> '12345',
    'ip_address'=> '100.200.300.400',
    'limit'=> 3,
    'basic'=> 1,
);

$params = http_build_query($params);

$opts = array(
  'http'=> array(
    'method'=> "GET",
    'header'=> "X-YourSurveys-Api-Key: $secret",
    'ignore_errors' => true,
  )
);

$url = 'https://www.your-surveys.com/suppliers_api/surveys/user';
$url = $url . '?' . $params;


$context = stream_context_create($opts);
/* Sends an http request to www.your-surveys.com/supppliers_api/surveys with additional headers shown above */
$fp = fopen($url, 'r', false, $context);
# Output all data from the response
fpassthru($fp);
fclose($fp);