Social

Read social numbers

social_analytics · Reads only · Markdown

How a channel did over 7, 30 or 90 days, or how one published post did: each metric the network reports, by day.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

How did our LinkedIn page do over the last 30 days?

Your agent callssocial_analyticsFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments

{
  "channel_id": "clx0d6k2v0001",
  "days": 30
}

What comes back

{
  "channel_id": "clx0d6k2v0001",
  "days": 30,
  "metrics": [
    {
      "metric": "Followers",
      "change_percent": 4,
      "by_day": [
        {
          "date": "2026-10-11",
          "value": "118"
        },
        {
          "date": "2026-10-12",
          "value": "120"
        }
      ]
    }
  ]
}

Use it when

Someone asks about followers, reach or likes.

What it does

How a channel did over the last 7, 30 or 90 days (channel_id), or one published post (post_id): each metric the network reports (followers, impressions, likes...) by day, with its change. Networks report different things, some nothing. Free.

What comes back

The channel_id or post_id, the days, and each metric the network reports (followers, impressions, likes and so on) with its change_percent and its values by day. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`channel_id`	string	A channel_id from social_channels. 1 to 64 characters, matches ^[A-Za-z0-9_-]+$.
`post_id`	string	A post_id from social_post or social_posts. 1 to 64 characters, matches ^[A-Za-z0-9_-]+$.
`days`	integer	One of: 7,30,90. Default: 7.

The call

Over MCP, call social_analytics on https://api.conecto.chat/mcp/social. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/social_analytics \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel_id":"clx0d6k2v0001","days":30}'

When it refuses

A refused call costs nothing and says what to do next.

Code	When	What to do
`invalid_input`400	Neither channel_id nor post_id was given.	Send one of the two.
`not_found`404	No channel of the business has that channel_id.	Call social_channels and use one of its channel_ids.
`no_channels`409	The business has no connected channel yet.	Connect one with social_connect.
`not_switched_on`503	Social posting is not switched on yet.	Try again later; nothing was charged.
`social_unavailable`503	The posting service did not answer, or could not open the business's social workspace.	Call again in a minute; when the message says so, tell Conecto's support.
`refused`400	The posting service refused the request; the message gives its reason.	Fix what the reason names, then call again.
`refused`422	The posting service reported a conflict with what is there.	Read the channel or post again, then call again.
`rate_limited`429	The posting service's limit of posts an hour was reached.	Try again later.

More Social tools

All 13 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md

Read social numbers

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Social tools

Give this to your agent.