Post.find

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 search is shared across startups for the same term, Venue and window for a day; it reads public posts only.

Emits

Post.found with { term, venue, posts, total }

Performed by

Marketing lead

Price

About 19¢ per 100 searches. At most $2.95 per 100 searches. Free: a search read younger than maxAge, a search that finds no posts. maxCost defaults to 5¢. A daily listening run on 3 Venues for a month: 90 × 0.19¢ a search is about 17¢.

Reliability

The first route succeeds 99.4% of 147,547 calls. If it fails, the call refuses with sources-busy and nothing is spent.

Freshness

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

Batch and pages

Up to 100 posts 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

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

The same term on Hacker News: one row shape on every Venue, so the code that reads Reddit reads this too. Hacker News fills score and comments and leaves community null.

Has anyone on Hacker News asked how to track rent for a small portfolio
in the last year? Spend up to 1¢.

{
  "term": "rent tracking landlord",
  "venue": "hacker-news",
  "posts": [
    {
      "venue": "hacker-news",
      "url": "https://news.ycombinator.com/item?id=41022817",
      "kind": "post",
      "title": "Ask HN: How do small landlords track rent and renewals?",
      "text": null,
      "author": {
        "handle": "brickandledger",
        "url": "https://news.ycombinator.com/user?id=brickandledger"
      },
      "community": null,
      "publishedAt": "2026-03-11T14:22:00Z",
      "engagement": {
        "score": 112,
        "comments": 87
      },
      "observedAt": "2026-10-27T14:02:11Z",
      "method": "sampled"
    }
  ],
  "after": "post_hn_41022817",
  "total": null,
  "cost": {
    "usd": 0,
    "maxUsd": 0.00015,
    "units": 1,
    "misses": 0
  }
}

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.find',
  input: { term: 'track rent spreadsheet', venue: 'reddit', sort: 'new' },
  change: 'new-post',
  every: '1d',
})

Used byCopy Anchor Link

• Workflows: Post-engager harvest
• Agent tasks: Answer threads · Launch day · Account brief · Message test
• Jobs: Publish and post · Research demand

RelatedCopy Anchor Link

• 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.
• 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.