BidSurvivor

The live advertising board: 2 slots a day of 12 hours each, showing which are held, by whom, for how much, and which are free. A slot with isFree true can be claimed for nothing with claim_free_slot.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

What it costs to take a specific slot right now: zero if nobody holds it, otherwise the amount a bid has to beat.

{
  "type": "object",
  "properties": {
    "dayKey": {
      "type": "string",
      "description": "UTC day, \"YYYY-MM-DD\". Defaults to today."
    },
    "slotIndex": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1,
      "description": "Which slot of the day, 0 to 1."
    }
  },
  "required": [
    "slotIndex"
  ],
  "additionalProperties": false
}

Put a product on the board in a slot nobody holds. Costs nothing: an empty slot has no standing bid to beat, so any amount takes it, zero included. No account and no card. The name, logo and description are read from the site automatically. One free claim per registrable domain per day, and only for today or tomorrow — booking further ahead is for bidders on the site. If somebody outbids it later the slot is lost, but nothing was paid, so nothing is lost with it.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The product's website, e.g. https://acme.com"
    },
    "slotIndex": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1,
      "description": "Which slot, 0 to 1. Call get_board first to find a free one."
    },
    "dayKey": {
      "type": "string",
      "description": "UTC day, \"YYYY-MM-DD\". Today by default; at most 1 day(s) ahead."
    },
    "name": {
      "type": "string",
      "description": "Overrides the name read from the site."
    },
    "tagline": {
      "type": "string",
      "description": "One line shown under the name."
    },
    "category": {
      "type": "string",
      "enum": [
        "seo",
        "agents",
        "media",
        "marketing",
        "sales",
        "devtools",
        "data",
        "productivity",
        "security",
        "finance",
        "crypto",
        "ecommerce",
        "education",
        "health",
        "games",
        "audio",
        "hiring",
        "agencies",
        "directories",
        "news",
        "domains",
        "attention",
        "travel",
        "property",
        "other"
      ],
      "description": "What the product is."
    }
  },
  "required": [
    "url",
    "slotIndex"
  ],
  "additionalProperties": false
}

Every brand that has held or contested a twelve-hour advertising slot, newest attention first, optionally filtered to one category. Each row carries what the placement delivered — card opens and click-throughs — and whether the brand bid for the slot or was placed on a free one by us. Use this to find a brandId for get_brand_stats.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Optional category id, e.g. devtools. Omit for all."
    },
    "limit": {
      "type": "number",
      "description": "Defaults to 50."
    }
  },
  "additionalProperties": false
}

The published numbers for one brand: slots held, card opens, and click-throughs to its own site. These are the same figures anyone can read on the site.

{
  "type": "object",
  "properties": {
    "brandId": {
      "type": "string",
      "description": "From get_board or claim_free_slot."
    }
  },
  "required": [
    "brandId"
  ],
  "additionalProperties": false
}

Brands that held a slot when it closed — plus whoever is leading the live slot right now — ranked by what they paid, over the last 7 days, 30 days or a year. Optionally filtered to one category.

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "enum": [
        "week",
        "month",
        "year"
      ],
      "description": "Defaults to week."
    },
    "category": {
      "type": "string",
      "enum": [
        "seo",
        "agents",
        "media",
        "marketing",
        "sales",
        "devtools",
        "data",
        "productivity",
        "security",
        "finance",
        "crypto",
        "ecommerce",
        "education",
        "health",
        "games",
        "audio",
        "hiring",
        "agencies",
        "directories",
        "news",
        "domains",
        "attention",
        "travel",
        "property",
        "other"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Defaults to 20."
    }
  },
  "additionalProperties": false
}

How much attention the board actually sends: visitors, page views, and click-throughs to brands. Published rather than claimed — this is a small board and the numbers say so.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}