Skip to main content
POST
Search posts by keyword across platforms. Every platform returns the same normalized post schema, so you parse LinkedIn, Twitter and Reddit results identically. Each post carries its author — a lead you can pass to Enrich Profile.

Credit Cost


Request Body

string
default:"linkedin"
Platform to search: linkedin, twitter, or reddit.
string
Search keyword or phrase in the post content (e.g., "looking for a CRM"). On Twitter you can use advanced operators (OR, quoted phrases, -word).
string
default:"strict"
Keyword matching mode:
  • strict (default) — only returns posts whose text actually contains the searched terms. Platforms match loosely by default (a keyword can appear only as a stock ticker, inside a link, or scattered across the post), so strict mode filters that noise out. Bare words are required (AND); quoted phrases are alternatives (OR).
  • loose — returns the platform’s raw results without post-filtering.
string
Freshness of the posts: past_24h, past_week, past_month. Mapped to each platform’s native time window.
string
default:"date_posted"
Ordering: date_posted (freshest first) or relevance (most relevant/engaged).
string
Reddit only. Restrict the search to one subreddit (e.g., "SaaS").
string
LinkedIn only. Restrict to posts by employees of a company — pass a name (auto-resolved to the company) or a numeric LinkedIn company ID.
string
LinkedIn only. Restrict to authors in an industry.
string
LinkedIn only. Restrict to authors with a job title (e.g., "Head of Sales").
string
LinkedIn only. Restrict to a content type: ARTICLE, VIDEO, PHOTO, DOCUMENT.
integer
default:"0"
Number of results to skip for pagination (LinkedIn).
integer
default:"10"
Number of posts to return. Maximum: 100 per request.
array
Attach the people who engaged with each returned post. Any of ["reactions", "comments"]. Each post then carries a reactions and/or comments array of engagers (name, headline, profile URL) — leads you can pass to Enrich Profile. Reddit has no reactions, so only comments applies there.
integer
default:"25"
Max engagers to return per type, per post, when include is set (1–1000).
string
Fetch the engagers of one specific post instead of running a keyword search. Pass a post URL; the response returns that single post with its reactions and comments arrays (bounded by engagement_count). Use include to restrict to one type.

Response

integer
Total matching posts on LinkedIn; a lower bound (enumerated so far) on Twitter/Reddit, which expose no global count — use has_next to know if more exist.
integer
Offset used for pagination.
integer
Number of results returned in this response.
boolean
Whether more results are available.
number
Credits used for this search.
array
List of posts, normalized across platforms. Same core fields everywhere; a few platform-specific extras on top.