Handle.measure

InputsCopy Anchor Link

OutputsCopy Anchor Link

On each VenueCopy Anchor Link

EffectsCopy Anchor Link

Action class

None: it reads, so no approval rule names it

Modes

• try: Runs the read and returns real rows; nothing is saved and nothing is billed.
• send: Returns a pending Action at once; its Event carries the rows when the read finishes.
• do: Waits for the read and returns the rows, billed per result.

Idempotency

The same Idempotency-Key with the same input replays the first answer at $0; with other input it returns 409.

Saved or shared

Nothing is written to your records. A reading is shared across startups for the same account for 7 days; it reads public accounts only.

Emits

Handle.measured with { venue, measures }

Performed by

Partner Manager

Price

About 19¢ per 100 accounts. At most 34¢ per 100 accounts. Free: an account that is gone or private, a reading younger than maxAge. maxCost defaults to 10¢. Ten shortlisted accounts, measured before you pick two: 10 × 0.19¢ an account is about 1.9¢.

Reliability

The first route succeeds 99.9% of 413,075 calls. If it fails, the call refuses with sources-busy and nothing is spent.

Freshness

A reading younger than 7 days returns at $0. Readings are shared across startups for the same subject and locale.

Batch and pages

Up to 25 accounts a call. It answers in one response.

Rate

The shared rate rules: 10 calls a second per key, and an array input counts as one call.

Capability

Market data

Refuses whenCopy Anchor Link

Every data call can also meet the shared data-call refusals: filter-unsupported, input-missing, limit-exceeded, max-cost, rate-limited, sources-busy.

{
  "type": "https://startupbuilder.dev/errors/venue-unsupported",
  "title": "The call does not read that search engine or network",
  "status": 422,
  "detail": "A search engine, answer engine or network the call does not read, such as ChatGPT sent to `Keyword.measure`.",
  "fix": "Pick one the call’s `venue` input lists; AI answers are `Keyword.ask`, posts are `Keyword.search`.",
  "next": {
    "verb": "Keyword.ask",
    "input": {
      "keyword": "best rent tracking software for a 40-unit property manager",
      "venues": [
        "chatgpt"
      ]
    }
  },
  "instance": "https://api.sb/leaseline.app/actions/action_1"
}

When it waitsCopy Anchor Link

Returns in one response; nothing waits.

ExampleCopy Anchor Link

A batch: three accounts in one call, one price cap, one cost. The private account is left out and costs nothing.

Compare @smalllandlordmath, @rentrollreview and @closedaccount on
YouTube; spend up to 2¢.

{
  "measures": [
    {
      "venue": "youtube",
      "handle": "@smalllandlordmath",
      "followers": 41200,
      "following": null,
      "postsRead": 30,
      "engagementRate": 0.046,
      "medianViews": 6800,
      "cadence": {
        "postsPerWeek": 1.5,
        "lastPostAt": "2026-10-23T15:00:00Z"
      },
      "topPosts": [
        {
          "url": "https://www.youtube.com/watch?v=rentroll40",
          "engagement": {
            "views": 61000,
            "reactions": 2400,
            "comments": 310
          }
        }
      ],
      "observedAt": "2026-10-27T14:02:11Z",
      "method": "sampled"
    },
    {
      "venue": "youtube",
      "handle": "@rentrollreview",
      "followers": 128000,
      "following": null,
      "postsRead": 30,
      "engagementRate": 0.009,
      "medianViews": 3100,
      "cadence": {
        "postsPerWeek": 0.5,
        "lastPostAt": "2026-09-02T18:00:00Z"
      },
      "topPosts": [
        {
          "url": "https://www.youtube.com/watch?v=rentroll2019",
          "engagement": {
            "views": 22000,
            "reactions": 410,
            "comments": 52
          }
        }
      ],
      "observedAt": "2026-10-27T14:02:11Z",
      "method": "sampled"
    }
  ],
  "cost": {
    "usd": 0,
    "maxUsd": 0.0057,
    "units": 2,
    "misses": 1
  }
}

To retry, send the same Idempotency-Key: the retry returns the first answer for $0. A new key reads again.

await $.Monitor.create({
  verb: 'Handle.measure',
  input: { handles: ['@smalllandlordmath'], venue: 'youtube' },
  change: 'engagement-drop',
  threshold: 0.2,
  every: '1w',
})

Used byCopy Anchor Link

None.

RelatedCopy Anchor Link

• Post.findRead the public posts on one Venue that use a term, newest or top first, with each author, community and how far it spread.
• Post.findEngagersList who reacted to or commented on one post, with what they said and where they work, priced per post, not per person.
• Handle.findList the accounts on one Venue that hold your buyers’ attention, by followers, engagement and topic, before a sponsorship or a guest spot.