search_posts
Find published posts by what they say: "find my post about our dog", "did I ever write about pricing?", "Alex's posts mentioning the launch". Searches every post on this workspace's channels, including history imported from LinkedIn and posts made outside DemandBird. Every word in query has to appear in the post (case-insensitive, up to 5 words), so use a few distinctive words, not a sentence; words past the 5th are ignored. No dates means all time. Returns the newest matches first, each with its post_id, date, a snippet, its headline numbers and a link, and says how many matched in all. There are no further pages: when there are more matches than limit, narrow with dates, platform or more words. No match says so. The post_id works with get_post_analytics and tag_published_post. To browse without words, use list_recent_posts or list_posts_with_metrics; for the best performers, list_top_posts.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_posts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many matches to show (default 10, max 25). | |
| query | Yes | The words to look for, e.g. "dog" or "pricing page". Every word must match. | |
| author | No | Whose posts to search. "me" for the person asking ("my post about..."), or a teammate's name ("Alex"). Omit for the whole workspace, which is what "our" / "the team" means. | |
| end_date | No | Optional. Only posts on or before this day, YYYY-MM-DD, inclusive. Omit for up to today. | |
| platform | No | Optional. Omit to search every platform. | |
| workspace | No | Optional: the workspace (client) to answer from for this call only, by name (e.g. 'Acme') or numeric id, as returned by list_workspaces. Leave it out to use the current workspace. It does not change the current workspace; use select_workspace for that. | |
| start_date | No | Optional. Only posts on or after this day, YYYY-MM-DD, in the user's timezone. Omit for all time. |