Get Topic Insights
get_topic_insights[Read · free] Surface the most-frequent topics in a profile's posts, with engagement context. Returns top N unigrams and (optionally) top N bigrams ranked by post count, each with avg_engagement, vs_baseline, and a sample_post_url. Mirrors the dashboard topics chart, server-side. Pass scope (a post_collections.id) to scope the analysis to a collection.
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": {
"profile_id": "<profile_id>"
},
"name": "get_topic_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| n | No | Max terms per list (default 15) | |
| scope | No | Optional post_collections.id to scope the analysis | |
| bigrams | No | Also compute and return top bigrams (default true) | |
| date_to | No | End date (ISO 8601) | |
| date_from | No | Start date (ISO 8601) | |
| profile_id | Yes | Tracked profile ID from list_profiles |