API Endpoint

POST /api/v1/ads/match

Submit a conversational prompt to execute vector similarity matching and Vickrey second-price auction scoring.

curl -X POST https://thematrixads.space/api/v1/ads/match \
  -H "Content-Type: application/json" \
  -H "X-Publisher-Key: mtx_pk_live_your_key" \
  -d '{
    "prompt": "Best managed Postgres for AI agents",
    "publisher_key": "mtx_pk_live_your_key"
  }'

200 OK Response Schema:

{
  "match": true,
  "impression_token": "eyJhdWN0aW9uSWQiOiI4ZjRhMWM5ZS...4f3e2d1c0b9a8f7e",
  "ad": {
    "id": "ad-uuid-ent-001",
    "format": "CARD",
    "headline": "ServerlessDB Managed Postgres",
    "body_text": "Auto-scaling PostgreSQL with instant database branching.",
    "cta_url": "https://thematrixads.space/api/v1/track/click?token=ey...",
    "disclosure_label": "Sponsored",
    "clearing_price_usd": "2.4800",
    "match_score": 0.924
  },
  "latency_ms": 28
}