DSP API

curl -X POST https://api.trillboards.com/openrtb/v2/onboard \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Acme Advertising",
    "seat_id": "acme_ads",
    "contact_email": "buyer@acme-ads.com"
  }'

# Response 201:
# {
#   "success": true,
#   "data": {
#     "seat_id": "acme_ads",
#     "api_key": { "key": "tb_dsp_a1b2c3..." }   <-- store this
#   }
# }

curl "https://api.trillboards.com/openrtb/v2/adslots?country=US&venue_type=retail" \
  -H "x-api-key: tb_dsp_YOUR_KEY"
# or:
# -H "Authorization: Bearer tb_dsp_YOUR_KEY"

curl -X POST https://api.trillboards.com/openrtb/v2/creatives \
  -H "x-api-key: tb_dsp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Sale 15s",
    "content_type": "video/mp4",
    "creative_url": "https://cdn.example.com/ads/summer-sale.mp4"
  }'

# Poll for moderation status:
# GET /openrtb/v2/creatives/:id  -> status: pending -> approved

curl -X POST https://api.trillboards.com/openrtb/v2/campaigns \
  -H "x-api-key: tb_dsp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "creative_id": "CREATIVE_ID",
    "name": "Summer Retail Push",
    "targeting": { "country": "US", "venue_type": "retail" }
  }'

curl -X POST https://api.trillboards.com/openrtb/v2/campaigns/assign \
  -H "x-api-key: tb_dsp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "creative_id": "CREATIVE_ID",
    "screen_ids": ["SCREEN_1", "SCREEN_2", "SCREEN_3"],
    "start_date": "2026-05-15",
    "end_date":   "2026-06-15"
  }'

# Option 1: x-api-key header
curl -H "x-api-key: tb_dsp_YOUR_KEY" ...

# Option 2: Bearer token
curl -H "Authorization: Bearer tb_dsp_YOUR_KEY" ...

# Every hour at minute 5
5 * * * * curl -s -H "x-api-key: $TRILLBOARDS_API_KEY" \
  "https://api.trillboards.com/openrtb/v2/adslots" \
  > /var/lib/your-product/trillboards-adslots.json

// Pulls /adslots and upserts into a Mongo `products` collection.
// Drop into a cron job, or schedule via your favorite job runner.
const fetch = require('node-fetch');
const { MongoClient } = require('mongodb');

const API_KEY = process.env.TRILLBOARDS_API_KEY;
const MONGO_URL = process.env.MONGO_URL;

async function ingest() {
  const res = await fetch(
    'https://api.trillboards.com/openrtb/v2/adslots',
    { headers: { 'x-api-key': API_KEY } }
  );
  if (!res.ok) throw new Error(`adslots ${res.status}`);
  const body = await res.json();
  const screens = body?.data?.screens ?? [];

  const client = await MongoClient.connect(MONGO_URL);
  const products = client.db().collection('products');

  for (const s of screens) {
    await products.updateOne(
      { external_id: s.screen_id },
      {
        $set: {
          external_id: s.screen_id,
          product_name: s.name,
          location: s.address,
          product_type: s.venue_type,
          ad_duration: s.slot_duration_seconds ?? 15,
          rate_card: s.floor_price_cpm,
          vendor: 'Trillboards',
          updated_at: new Date(),
        },
      },
      { upsert: true }
    );
  }
  await client.close();
  console.log(`upserted ${screens.length} screens`);
}

ingest().catch((e) => { console.error(e); process.exit(1); });

# Drop into your scheduler (Airflow, cron, Prefect, etc.).
import os
import requests
from pymongo import MongoClient, UpdateOne
from datetime import datetime, timezone

API_KEY = os.environ['TRILLBOARDS_API_KEY']
MONGO_URL = os.environ['MONGO_URL']

def ingest():
    resp = requests.get(
        'https://api.trillboards.com/openrtb/v2/adslots',
        headers={'x-api-key': API_KEY},
        timeout=30,
    )
    resp.raise_for_status()
    screens = resp.json().get('data', {}).get('screens', [])

    client = MongoClient(MONGO_URL)
    products = client.get_default_database()['products']

    ops = []
    for s in screens:
        ops.append(UpdateOne(
            {'external_id': s['screen_id']},
            {'$set': {
                'external_id':   s['screen_id'],
                'product_name':  s['name'],
                'location':      s.get('address'),
                'product_type':  s.get('venue_type'),
                'ad_duration':   s.get('slot_duration_seconds', 15),
                'rate_card':     s.get('floor_price_cpm'),
                'vendor':        'Trillboards',
                'updated_at':    datetime.now(timezone.utc),
            }},
            upsert=True,
        ))
    if ops:
        products.bulk_write(ops, ordered=False)
    client.close()
    print(f'upserted {len(ops)} screens')

if __name__ == '__main__':
    ingest()

{
  "success": false,
  "error": "<human-readable string>",
  "error_code": "<snake_case_code>",
  "request_id": "req_<uuid>",
  // ...optional extras: param, retry_after_seconds,
  //                    required_scope, granted_scopes, nbr (bid only)
}