Integration Architecture

PromptBid is an exchange layer. One API call triggers a real-time auction across demand partners and returns the winning ad — all under 100ms. No SDK lock-in. No framework dependencies. Standard OpenRTB 2.6.

Supply Side — For Builders

Your application sends a bid request with conversation context. PromptBid runs a second-price auction across demand partners and returns the winning creative. You render it, we handle billing.

Your AI App

Sends bid request

PromptBid Exchange

Runs auction <100ms

Demand Partners

Compete on price

Revenue

60-75% to builder

JavaScript / TypeScript

import PromptBid from '@promptbid/sdk' const pb = PromptBid.init({ apiKey: 'pk_...' }) // Request an ad with conversation context const ad = await pb.getAd({ context: conversationText, format: 'sponsored-reply', placement: 'after-response' }) // Render and track pb.render(ad, targetElement) pb.track(ad.id, 'impression')

View Docs

Python

from promptbid import PromptBid pb = PromptBid(api_key="pk_...") # Request an ad with conversation context ad = pb.get_ad( context=conversation_text, format="sponsored-reply", placement="after-response" ) # Return ad content alongside response response["ad"] = ad.creative

View Docs

REST API — OpenRTB 2.6

POST /api/v1/bid/openrtb Authorization: Bearer pk_... Content-Type: application/json { "id": "req_abc", "imp": [{ "id": "1", "ext": { "context": "user asking about..." } }], "app": { "bundle": "com.myapp" }, "device": { "ua": "..." } }

OpenRTB Spec

Ad Formats

Two ad formats designed for conversational interfaces. Each can be requested via the same API — specify the format in your bid request and we return the appropriate creative.

FORMAT

Demand Side — For Advertisers

Buy inventory through our self-serve dashboard or programmatically via API. Target by conversation context, not user profiles — no cookies, no tracking pixels, no PII.

SELF-SERVE

Campaign Manager

Create campaigns, set budgets, define context-based targeting, and monitor performance in real time. Upload creatives, A/B test copy, and adjust bids without writing code.

Get Started

API

Programmatic Buying

Full REST API for campaign management, creative upload, bid adjustments, and reporting. Webhook support for real-time event callbacks. OpenRTB 2.6 compliant bid responses.

API Reference

REPORTING

Analytics & Exports

Real-time dashboards with impression, click, and conversion data. Export via CSV, JSON, or scheduled delivery to your data warehouse. Granular breakdowns by app, format, and context category.

View Dashboard

Built on OpenRTB 2.6

PromptBid extends the IAB OpenRTB 2.6 protocol with fields for conversational context, intent signals, and AI-native ad formats. If your systems already speak OpenRTB, integration is minimal.

Standard OpenRTB 2.6 bid request/response format
Extended imp.ext fields for conversation context and intent
Second-price auction with floor price support
Differential privacy applied to all context signals
No user-level tracking — context-only targeting

Read the Full Spec

{
  "id": "req_abc",
  "imp": [{
    "id": "1",
    "bidfloor": 10.0,
    "ext": {
      "context": "travel planning",
      "intent": "booking",
      "format": "sponsored-reply"
    }
  }],
  "app": {
    "bundle": "com.example.assistant",
    "cat": ["IAB20"]
  }
}