Browse documentation

Tool

Get my account insights

Use to compare a connected account's performance with the previous period and review daily trends. Reads stored analytics only.

POSTtools.readFree
POST/openapi/v1/tools/get_my_account_insights

Call it

curl -X POST https://api.cuekoo.com/openapi/v1/tools/get_my_account_insights \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel_id":"<id>"}'

The MCP tool is named cuekoo_get_my_account_insights. Arguments and results are identical to the REST call.

Arguments

Send a JSON object with these fields. Scope: tools.read.

NameTypeRequired
channel_idstringRequired
fromstringOptional
time_zonestringOptional
tostringOptional

Response

NameTypeRequired
channel_idstringRequired
currentobjectRequired
current.follower_changeinteger | nullRequired
current.followersinteger | nullRequired
current.metricsobjectRequired
current.metrics.commentsinteger | nullRequired
current.metrics.likesinteger | nullRequired
current.metrics.savesinteger | nullRequired
current.metrics.sharesinteger | nullRequired
current.metrics.viewsinteger | nullRequired
current.postsintegerRequired
dailyobject[] | nullRequired
daily[].datestringRequired
daily[].engagement_ratenumber | nullRequired
daily[].engagementsinteger | nullRequired
daily[].followersinteger | nullRequired
daily[].postsintegerRequired
daily[].viewsinteger | nullRequired
fromstringRequired
last_synced_atstring | nullRequired
previousobjectRequired
previous.follower_changeinteger | nullRequired
previous.followersinteger | nullRequired
previous.metricsobjectRequired
previous.metrics.commentsinteger | nullRequired
previous.metrics.likesinteger | nullRequired
previous.metrics.savesinteger | nullRequired
previous.metrics.sharesinteger | nullRequired
previous.metrics.viewsinteger | nullRequired
previous.postsintegerRequired
sync_statusstringRequired
time_zonestringRequired
tostringRequired

A call returns the Tool's output object at HTTP 200. Failures use the error envelope.

Credits

This Tool is free. It does not reserve or spend credits.