Skip to main content
The Data API requires secure authentication for all requests using a combination of an API key and a request signature to ensure your data stays secure.

​
Required credentials

Each endpoint requires that you pass both of the following elements together:
  • API Key (Query Parameter): apiKey=<your-api-key>
  • Request Signature (Query Parameter): sig=<computed-signature>

​
Computing the signature

The signature is an MD5 hash computed using your API key, your secret, and a Unix timestamp. 
import hashlib
import time

def compute_signature(api_key: str, secret: str) -> str:
    timestamp = str(int(time.time()))
    string_to_sign = f"{api_key}{secret}{timestamp}"
    return hashlib.md5(string_to_sign.encode('utf-8')).hexdigest()

api_key = "your-api-key"
secret = "your-secret"
signature = compute_signature(api_key, secret)

url = f"https://api-universal.conductor.com/data-api/v1/keyword_rankings?apiKey={api_key}&sig={signature}"