Get trends
What is trending on one network, from the network's own trends read (X, Mastodon).
POST /api/v1/get_trends · MCP tool get_trends · scope read
What is trending on one network, from the network's own trends read (X, Mastodon). A network with no trends read says why; a refresh never starts a model call. Free by default: it serves what this app already stored, with `asOf`. `refresh: true` makes ONE live read of at most 25 items. On X a refresh is billed: 1 credit per post read and 2 credits per user read, 2 credits per trends read (X's published rates), checked against your credits first. Each refresh is billed on its own: repeating one is NOT free. At most 50 billed refreshes per key and 100 per workspace (all keys together) per UTC day, one at a time per workspace (a second in flight is refused as busy); the Free plan does not read X. A refresh needs the brand's read switch for that kind on (Agent → Permissions), and a billed refresh needs the key's `spend` scope as well as `read`. Bluesky, Mastodon and other free networks cost nothing. Stored data is served even while a connection needs reconnecting. No agent run, no model. Text other people wrote (posts, authors, URLs of their posts) comes back only under `untrusted`, keyed by item id.
Scope. Read your own brand data: posts, metrics, runs, the audit trail, the plan, stored mentions and trends. Free, unless you ask a billed network for a fresh read. A fresh read on a billed network costs credits and needs spend; stored data is free.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
network | "x" | "bluesky" | "mastodon" | "pixelfed" | "telegram" | "devdotto" | "discord" | "ghost" | "lemmy" | "nostr" | "tumblr" | "wordpress" | "misskey" | "qiita" | "tabnews" | "youtube" | "dailymotion" | "tiktok" | "hashnode" | "peertube" | "dribbble" | "slack" | "wykop" | "plurk" | "kick" | "twitch" | "hatena" | "line" | No | Connected network id (from get_capabilities). Omit for the brand's primary. |
limit | integer | No | Items, at most 25. |
refresh | boolean | No | true = one live read (may be billed, see description). Default: stored data. |
scope | "general" | "niche" | No | Trends: niche (default) or general. |
Request
curl -X POST https://growsocialelion.com/api/v1/get_trends \
-H "Authorization: Bearer gse_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{}'Response
200 with the tool's answer. The shape below is generated from the output schema; real answers can carry more fields.
{
"status": "string",
"code": "string",
"reason": "string",
"network": "string",
"source": "string",
"asOf": "string",
"items": [
{
"id": "string"
}
],
"cost": {
"billed": false
},
"untrusted": {
"notice": "string"
}
}Errors use the shared body. See Errors. The full schema is in the API reference.