get_format_performance
Answer "what type of post works best?", "do images or videos perform better?", "which format gets the most engagement?" for a platform. Ranks post formats (text, image, video, etc.) by engagement. On LinkedIn it is each format's median engagement rate per post, with how many posts it is based on, so a format with only a post or two can be read with care; it covers member profiles' posts only, not company pages. With too few posts it says there isn't enough data yet. WHOSE POSTS: pass author whenever the question names one. "my"/"I" -> author: "me". A person's name -> that name, e.g. author: "Alex". "our"/"the team", or no one named -> omit author for the whole workspace. For overall numbers use get_analytics_summary; for single posts, 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": {
"platform": "<platform>"
},
"name": "get_format_performance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| author | No | Whose posts to compare. "me" for the person asking, or a teammate's name for theirs ("Alex"). Omit for the whole workspace, which is the default and is what "our" / "the team" means. | |
| 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 | Yes | Required. The network to analyze. | |
| 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 a custom range, YYYY-MM-DD, in the user's timezone. Use for windows the presets don't cover: "last 14 days", "in March", "since Jan 1", "last year". Overrides `period`. Ranges can cover up to 366 days. |