Ads · SalesBuilder

A Data Verb reads the market and returns a reading. A Software Verb changes your records and emits an Event. Every call here is a Data Verb: it reads, and it changes a record only where its Effects say so.

Properties

Field	Type	What `null` means
`ads`	`Ad[]`	Never null: empty when none ran, at $0; absent with `countOnly`.
`ads[].advertiser`	`{ name: string; hostname: Hostname \| null }`	Never null; `hostname: null` when the page names no site.
`ads[].venue`	`VenueId`	Never null.
`ads[].format`	`'text' \| 'image' \| 'video' \| 'carousel'`	Never null.
`ads[].headline`	`string \| null`	The format has no headline.
`ads[].body`	`string \| null`	The format has no body copy.
`ads[].cta`	`string \| null`	No button.
`ads[].landingUrl`	`string \| null`	The library does not show it.
`ads[].mediaUrl`	`string \| null`	A text ad, or the library does not serve the file.
`ads[].firstSeen`	`string \| null`, in date	The library does not show a start date.
`ads[].lastSeen`	`string \| null`, in date	The library does not show it.
`ads[].daysRunning`	`number \| null`, in days	No start date, so unknown; never zero.
`ads[].transparencyUrl`	`string \| null`	The site’s library has no page for it.
`ads[]`	`Observed`	Each ad also carries `observedAt` and `method`.
`total`	`number \| null`, in ads	The library reports no total.
`after`	`Cursor`	The last page: there are no more rows.
`cost`	`Cost`, in USD	Never null. In try mode `usd` is 0 and `maxUsd` is what the call would have cost.

Object

JSON

{
  "ads": [
    {
      "advertiser": {
        "name": "RentRival",
        "hostname": "rentrival.example"
      },
      "venue": "facebook",
      "format": "image",
      "headline": "Stop chasing rent in spreadsheets",
      "body": "Owners get statements on the 1st. Free for 14 days.",
      "cta": "Sign up",
      "landingUrl": "https://rentrival.example/pm",
      "mediaUrl": null,
      "firstSeen": "2026-06-02",
      "lastSeen": "2026-10-26",
      "daysRunning": 146,
      "transparencyUrl": null,
      "observedAt": "2026-10-27T14:02:11Z",
      "method": "sampled"
    },
    {
      "advertiser": {
        "name": "RentRival",
        "hostname": "rentrival.example"
      },
      "venue": "linkedin",
      "format": "text",
      "headline": "Renewal notices, sent on time, every time",
      "body": "For property managers with 50 to 500 doors.",
      "cta": "Book a demo",
      "landingUrl": "https://rentrival.example/renewals",
      "mediaUrl": null,
      "firstSeen": "2026-10-08",
      "lastSeen": "2026-10-26",
      "daysRunning": 18,
      "transparencyUrl": null,
      "observedAt": "2026-10-27T14:02:11Z",
      "method": "sampled"
    }
  ],
  "total": 37,
  "after": "ad_k2Lw",
  "cost": {
    "usd": 0,
    "maxUsd": 0.0036,
    "units": 2,
    "misses": 0
  }
}