Skip to main content
{
  "bidId": "bid_abc123",
  "realizedPrice": 7.50,
  "production": true
}

{
  "data": {
    "advertiser": "nike.com",
    "headline": "Premium Running Shoes",
    "description": "Perfect for marathon training. Lightweight and comfortable.",
    "cta_text": "Learn more",
    "url": "https://your-dsp-domain.com/api/v1/view/token_abc123",
    "image_url": null,
    "view_url": "https://your-dsp-domain.com/api/v1/view/token_abc123"
  }
}
Implementation Required: Your DSP must implement this endpoint on your own server. The SSP at ssp.thrads.ai will send POST requests to your configured DSP endpoint URL.

​
Authorizations

​
Content-Type
string
required
Must be application/json
This endpoint does not require API key authentication when called by SSP. Authentication is handled at the SSP level.

​
Body

​
bidId
string
required
The bid identifier from the winning bid response. Must match a valid bid in cache (TTL: ~60 seconds).
​
realizedPrice
float
required
The actual clearing price from the auction (what the winner pays). In first-price auctions, this matches the winning bid amount.
​
production
boolean
default:"true"
Whether the request is for production. Defaults to true.
{
  "bidId": "bid_abc123",
  "realizedPrice": 7.50,
  "production": true
}

{
  "data": {
    "advertiser": "nike.com",
    "headline": "Premium Running Shoes",
    "description": "Perfect for marathon training. Lightweight and comfortable.",
    "cta_text": "Learn more",
    "url": "https://your-dsp-domain.com/api/v1/view/token_abc123",
    "image_url": null,
    "view_url": "https://your-dsp-domain.com/api/v1/view/token_abc123"
  }
}

​
Response

​
data
object
required
REQUIRED - Ad creative response payload.
​
error
string
Error message when the request fails. Only present on error responses.
No extra fields allowed: The response model uses strict validation (extra="forbid"). If your response includes any field not listed above, validation will fail and the ad will be dropped (no-bid returned to publisher). For example, adding "custom_tracking": "something" to the data object will cause the entire render response to be rejected.
Click URL requirement: We append a view_url parameter to the click URL for impression verification. Your click tracker must pass through or ignore unknown query parameters.

​
Status Codes

Status CodeMeaningScenario
200 OKSuccessAd creative generated successfully
400 Bad RequestValidation errorMissing required fields (description or url) or invalid data types
404 Not FoundBid not foundBid expired (TTL ~60s), invalid bidId, or bid not in cache
500 Internal Server ErrorServer errorLLM service unavailable, creative generation failed, or database error