Bid Request

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1234567890

import uuid
import requests

BASE_URL = "https://ssp.thrads.ai/api/v1/ssp/bid-request"
API_KEY = "your-api-key"


def get_user_id():
    # Use your own anonymous, non-PII user identifier
    return f"user_{uuid.uuid4()}"


def get_chat_id():
    # One chat_id per conversation
    return f"chat_{uuid.uuid4()}"


def make_bid_request(conversation_messages, production=True, turn_number=0, ad_type="", client_id=None):
    payload = {
        "userId": get_user_id(),
        "chatId": get_chat_id(),
        "client_id": client_id,
        "messages": conversation_messages,
        "production": production,
        "turn_number": turn_number,
        "adtype": ad_type,
    }

    headers = {
        "thrad-api-key": API_KEY,
        "Content-Type": "application/json",
    }

    response = requests.post(BASE_URL, json=payload, headers=headers, timeout=5)
    response.raise_for_status()
    data = response.json()

    bid = data.get("data", {}).get("bid")
    if bid:
        print("Got bid:", bid)
    else:
        print("No bid available")

    return data

/**
 * Get or create persistent anonymous user ID
 * REQUIRED: You must implement this to track users across sessions
 */
function getUserId() {
  const STORAGE_KEY = 'thrad_user_id';
  let userId = localStorage.getItem(STORAGE_KEY);
  
  if (!userId) {
    // Generate new anonymous ID (no PII - just a random UUID)
    userId = 'user_' + crypto.randomUUID();
    localStorage.setItem(STORAGE_KEY, userId);
  }
  
  return userId;
}

/**
 * Get or create chat ID (one per conversation)
 * REQUIRED: You must implement this to track ads per conversation
 */
function getChatId() {
  const STORAGE_KEY = 'thrad_chat_id';
  let chatId = sessionStorage.getItem(STORAGE_KEY);
  
  if (!chatId) {
    chatId = 'chat_' + crypto.randomUUID();
    sessionStorage.setItem(STORAGE_KEY, chatId);
  }
  
  return chatId;
}

// Make bid request
const response = await fetch('https://ssp.thrads.ai/api/v1/ssp/bid-request', {
  method: 'POST',
  headers: {
    'thrad-api-key': 'your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    userId: getUserId(),
    chatId: getChatId(),
    client_id: "client_abc", // Optional: identifier for your sub-client or network partner
    messages: conversationMessages,
    production: true,
    turn_number: currentTurn,
    adtype: "" // or "opener" for pre-conversation ads
  })
});

const data = await response.json();

if (data.data.bid) {
  // Display ad creative
  console.log('Ad:', data.data.bid);
} else {
  // No bid - continue without ad
  console.log('No ad available');
}