GTM verbs

post/v1/find_posts

Request

  • Base URL: https://api.layrcake.dev
  • URL: https://api.layrcake.dev/v1/find_posts
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional stable retry key.

Request body

querystring
company_domainstring

Company website domain or URL, e.g. acme.com or https://www.acme.com/about

intent'pain' | 'question' | 'any' | 'competitor_complaint' | 'hiring_for_it'
audiencestring
platformsstring[]
within_daysinteger
limitinteger
includestring[]
budget_creditsnumber

Leads mode, or engagers_of with read_all: a spend ceiling in credits. Leads beyond it come back not_processed; read_all reads people up to it.

engagers_ofstring[]

Engagers mode: up to 5 post URLs (LinkedIn, X, Reddit, Facebook). Returns the people who reacted, commented, replied or reposted. Send no query, platforms, intent or audience.

per_postinteger

Engagers mode: up to this many people from each source (reactions, comments, replies) of each post.

author_filterstring[]

Engagers mode: keep only people whose headline contains one of these words, e.g. ["head of sales", "VP sales"]. Each person read costs a small scan fee; Reddit and Facebook are skipped (no headlines).

read_alltrue

Engagers mode: read everyone who engaged, not a sample, in the background (about 2 minutes per 500 people). Needs budget_credits and idempotency_key. Returns an operation: poll get_operation, which returns the people 25 at a time with next_cursor.

Response

Successful outcome

Changes

No recorded changes to this operation across all 1 revision of this API.