Tool reference/analytics

ANALYTICS

get_best_performing_content

Return up to five Caroush posts ranked by reported views in a publication-date cohort. Pro is required. Posts without available view metrics are excluded; comparisons across platforms have different view definitions.

Read onlyread:analytics
Take the docs with youMarkdown for your editor or agent.
Download guide
TransportStreamable HTTP
Methodtools/call
ExecutionImmediate handler

Request contract

Input parameters

daysstring
"7""30""90""all"
social_account_idinteger
providerstring
"instagram""tiktok""facebook""linkedin""twitter""threads""bluesky"
media_typestring
"all""photo""video""text"

Exact JSON schemas

These are the schemas exported by the Caroush MCP server.

Input schema · JSON
{
  "type": "object",
  "properties": {
    "days": {
      "type": "string",
      "enum": [
        "7",
        "30",
        "90",
        "all"
      ]
    },
    "social_account_id": {
      "type": "integer",
      "minimum": 1
    },
    "provider": {
      "type": "string",
      "enum": [
        "instagram",
        "tiktok",
        "facebook",
        "linkedin",
        "twitter",
        "threads",
        "bluesky"
      ]
    },
    "media_type": {
      "type": "string",
      "enum": [
        "all",
        "photo",
        "video",
        "text"
      ]
    }
  },
  "required": [],
  "additionalProperties": false
}

Read the actual outcome

A successful handler response does not necessarily mean generation or publication is finished. Follow the returned operation, native run or schedule status. Results and job states

Back to all 49 tools