What is the Thrad DSP API?
The Thrad DSP API allows your DSP to participate in real-time first-price auctions for conversational ad placements. Your DSP will receive bid requests from active chat conversations, submit bids, and generate ad creatives when you win auctions.How It Works
The Thrad SSP (hosted atssp.thrads.ai) orchestrates real-time auctions by calling your DSP endpoints:
- Bid Request: SSP sends conversation context to your DSP
- Your Response: You return a bid (or no-bid). Timeout is 2 seconds.
- Auction: SSP runs a first-price auction across all DSP bids
- Render: If you win, SSP requests the ad creative from your DSP. Timout is 1 second.
- Delivery: SSP delivers your ad to the publisher (DeepAI)
What You Need to Implement
Your DSP must implement two endpoints on your own server:1. Bid Endpoint
Receives bid requests and returns bid amounts Example:POST https://your-dsp.com/api/v1/dsp/bid/
2. Render Endpoint
Generates ad creatives for winning bids Example:POST https://your-dsp.com/api/v1/dsp/render-ad
The endpoint URLs are examples. You can use any URL structure you prefer. Just configure your actual endpoint URLs with the Thrad team.
Key Information
- Traffic Volume: ~50,000 requests/hour with peaks of 30 req/sec
- Floor Price: $4.00 CPM minimum (gross bid)
- Commission: SSP takes 10% commission from your bid
- Timeouts: 2 seconds for bid, 1 second for render
- Auction Type: First-price (winner pays their bid)
Authentication
Recommended: Set up an API key on your side and provide it to the Thrad team. The SSP will include this key in all requests to your endpoints:If you prefer to secure your endpoints differently (e.g., domain-based firewall rules), discuss your approach with the Thrad team during integration setup.
Next Steps
Integration Guide
Learn about traffic, pricing, and integration steps
API Reference
View detailed endpoint specifications