Get Threads User Insights
threads_get_user_insightsRetrieve account-level Threads metrics: views, likes, replies, reposts, quotes, followers count, reach, and follower demographics broken down by age, country, city, or gender.
Instructions
Gets account-level metrics for the authenticated Threads user.
Args:
threads_user_id (string): Threads user ID
metrics (string[]): Options: Time-series: views, likes, replies, reposts, quotes, followers_count, reach Demographics: follower_demographics (breakdown by age, country, city, gender — requires 100+ followers)
since (string, optional): Start date YYYY-MM-DD (required for time-series metrics)
until (string, optional): End date YYYY-MM-DD
breakdown (string, optional): For follower_demographics: 'age', 'country', 'city', 'gender'
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": {
"threads_user_id": "<threads_user_id>"
},
"name": "threads_get_user_insights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| since | No | ||
| until | No | ||
| metrics | No | ||
| breakdown | No | For follower_demographics metric only | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |
| threads_user_id | Yes |