Skip to main content

Getting Started with Bid API

Quick introduction to integrating with Affinity AI's Bid API for programmatic advertising.

Overview​

The Bid API is Affinity AI's core programmatic advertising interface, built on OpenRTB 2.6 with optional extensions for AI-native advertising. Whether you're a publisher monetizing content or an advertiser reaching audiences, the Bid API provides flexible integration options.

Prerequisites​

Before you begin:

  • ✅ Basic understanding of OpenRTB 2.6 protocol
  • ✅ HTTPS-enabled website or application
  • ✅ Ability to make HTTP POST requests and parse JSON
  • ✅ Development environment for testing

Quick Start​

For Publishers​

Monetize your content with programmatic advertising:

  1. Choose Integration Level - Start simple or go advanced
  2. Send Bid Requests - POST to /openrtb2 endpoint
  3. Render Responses - Display winning ads
  4. Track Performance - Monitor fill rates and revenue

👉 Use Cases - Explore real-world implementation examples

API Endpoints​

https://bid-aura.affinity.net/openrtb2

Basic Request Example​

curl -X POST https://bid-aura.affinity.net/openrtb2 \
  -H "Content-Type: application/json" \
  -d '{
    "id": "request-123",
    "imp": [{
      "id": "1",
      "native": {
        "request": "{\"native\":{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":80}}]}}"
      }
    }],
    "site": {
      "id": "site-456",
      "domain": "example.com",
      "publisher": {
        "id": "my-publisher-id"
      }
    }
  }'

Basic Response Example​

{
  "id": "request-123",
  "seatbid": [
    {
      "bid": [
        {
          "id": "bid-789",
          "impid": "1",
          "price": 2.5,
          "adm": "<creative markup>",
          "adomain": ["advertiser.com"],
          "crid": "creative-101"
        }
      ]
    }
  ],
  "cur": "USD"
}

What's Included​

Core Features​

  • OpenRTB 2.6 Standard - Industry-standard protocol
  • Native Ad Format - Native advertising support
  • Low Latency - Sub-100ms response times
  • Global Reach - Multi-region deployment

Optional Extensions​

  • Context Enhancement - AI-powered contextual signals for better targeting
  • AdCP Protocol - Advanced creative assembly and tracking
  • AI-Native Formats - Contextual weaving for conversational platforms

Integration Options​

The Bid API supports multiple integration approaches - from basic OpenRTB to advanced AI-native advertising. You can start simple and add features as needed.

Available options:

  • Basic OpenRTB - Standard protocol integration
  • With AdCP - Enhanced creative assembly and tracking
  • With Context - AI-powered contextual targeting
  • AI-Native - Contextual weaving for conversational platforms

See the Use Cases for detailed implementation examples.

Example Request​

Here's a minimal bid request to get you started:

curl -X POST https://bid-aura.affinity.net/openrtb2 \
  -H "Content-Type: application/json" \
  -d '{
    "id": "request-123",
    "imp": [{
      "id": "1",
      "native": {
        "request": "{\"native\":{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":80}}]}}"
      }
    }],
    "site": {
      "domain": "example.com",
      "publisher": {
        "id": "my-publisher-id"
      }
    }
  }'

Next Steps​

  1. OpenRTB Endpoint Reference - Understand the API in detail
  2. Use Cases - Explore real-world scenarios
  3. AdCP Extensions - Advanced creative capabilities

Resources​

Support​

Need help? Contact support@aura.tech or check our use cases for implementation examples.