list_posts_with_metrics
List EVERY published post in a date range, newest first, a page at a time, with all its numbers. Use it for a full history or export ("all my posts this year with their stats"); for the best or worst few, use list_top_posts; to find one by its words, search_posts. Ranges may be longer than a year. Each post shows what its platform reports, as of the latest sync, so recent posts are still growing and platforms differ (LinkedIn adds members reached, saves, sends and more; a company page has fewer). When the reply ends with a cursor, call again with the same arguments plus that cursor for the next page; the last page has none. An empty range says "No posts found". Each row's post_id works with get_post_analytics and tag_published_post.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_posts_with_metrics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Posts per page (default 50, max 100). | |
| author | No | Whose posts. "me" for the person asking, or a teammate's name. Omit for the whole workspace. | |
| cursor | No | The cursor the previous page ended with. Omit for the first page. | |
| period | No | Rolling window ending today. Default 30d. For any other window, pass start_date/end_date instead. | |
| end_date | No | Optional. Last day of a custom range, YYYY-MM-DD, inclusive. Defaults to today. Needs start_date. | |
| platform | No | Optional. Omit for 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. First day of the range, YYYY-MM-DD, in the user's timezone. Overrides `period`. Any length of range is allowed. |