Post.findEngagers

InputsCopy Anchor Link

OutputsCopy Anchor Link

On each VenueCopy Anchor Link

EffectsCopy Anchor Link

Action class

None: no approval rule names it, so it runs within its seat’s Permissions and Limits

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

Rows are returned, not saved, unless you pass save. Readings about people are never shared across startups.

Emits

Post.engagersFound with { post, engagers }

Performed by

Prospector

Price

About 0.3¢ a post. At most 0.8¢ a post. Free: a post that is gone or private, saving rows as Prospects. maxCost defaults to 5¢. The engagers on 20 posts about your problem: 20 × 0.3¢ a post is about 6¢.

Reliability

The first route succeeds 99.95% of 44,205 calls. If it fails, the call refuses with sources-busy and nothing is spent.

Freshness

A reading younger than 6 hours returns at $0. Readings about people are never shared across startups.

Batch and pages

Up to 100 comments and 100 reactions a page. Pages of 25 rows by default, 100 at most; pass after for the next page. 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

Enrichment

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 refusal: Hacker News has no engager read yet, so the call refuses before it spends and next names the read that does.

Who commented on this Hacker News thread about rent tracking?

{
  "type": "https://startupbuilder.dev/errors/venue-unsupported",
  "title": "The call does not read that search engine or network",
  "status": 422,
  "detail": "Post.findEngagers does not read Hacker News.",
  "fix": "Read the thread’s comments with Post.find and kinds: ['comment'], then take their authors.",
  "next": {
    "verb": "Post.find",
    "input": {
      "term": "rent tracking landlord",
      "venue": "hacker-news",
      "kinds": [
        "comment"
      ]
    }
  },
  "instance": "https://api.sb/leaseline.app/actions/action_Hn4vQ8"
}

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

await $.Monitor.create({
  verb: 'Post.findEngagers',
  input: {
    post: 'https://www.linkedin.com/posts/rentrival_rent-roll-chaos-7134'
  },
  change: 'new-engager',
  every: '6h',
})

Used byCopy Anchor Link

• Workflows: Post-engager harvest
• Jobs: Find your first customers

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.
• Handle.findList the accounts on one Venue that hold your buyers’ attention, by followers, engagement and topic, before a sponsorship or a guest spot.
• Handle.measureRead any public account’s followers, engagement rate and posting cadence from its last 30 posts, before you sponsor it, pitch it or copy it.