Search Social Posts
search_postsRead-onlyIdempotent
Search social posts by keyword on LinkedIn, Twitter, or Reddit to find buying intent, then attach engagers as leads for targeted outreach.
Instructions
Search social posts by keyword on LinkedIn, Twitter/X, or Reddit — or target a single post by URL. Great for intent signals: find people talking about a topic, then use include to attach the post's engagers (each reactor / commenter is a lead, with their profile).
Two modes:
Keyword search: set
keyword(+ optional filters).Single post: set
post_url(withincludeto get its engagers).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of posts to return. | |
| match | No | 'strict' (default) keeps only posts whose text actually contains the searched terms; 'loose' returns the platform's raw results. | strict |
| offset | No | Pagination offset. | |
| include | No | Attach engagers to each returned post: any of ['reactions', 'comments']. Each engager is a lead. (Reddit exposes comments only — no upvoters.) | |
| keyword | No | Search keyword in post content. Required unless `post_url` is set. | |
| sort_by | No | Sort order. | date_posted |
| platform | No | Platform to search. | |
| post_url | No | Target a single post by URL instead of a keyword search. Use with `include` to get its engagers. | |
| subreddit | No | Reddit only: restrict the search to one subreddit (e.g. 'SaaS'). | |
| date_posted | No | Filter by post freshness. | |
| from_member | No | LinkedIn only: posts authored by this member URN (e.g. ACoAABxxxxxx). | |
| content_type | No | LinkedIn only: filter by content type. | |
| author_company | No | Filter by the post author's company name. | |
| author_industry | No | Filter by the post author's industry. | |
| author_job_title | No | Filter by the post author's job title. | |
| engagement_count | No | Max engagers per type, per post, when `include` is set. | |
| from_organization | No | LinkedIn only: posts authored by this organization id (numeric). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of posts returned in this page. | |
| error | No | HTTP-style status code, present only when the call failed. | |
| total | No | Number of posts matching the search (lower bound when has_next is true). | |
| detail | No | Error message, present only when the call failed. | |
| offset | No | Pagination offset of this page. | |
| results | No | Post objects (author, text, engagement counts, and engagers when `include` is set). | |
| has_next | No | Whether more results are available. | |
| credits_used | No | Credits consumed by this search. |