PostMyIsh

API reference

Get analytics

Pull reach, engagement, and follower totals per network.

GET/api/v1/analytics

Requires a Bearer API key — see authentication.

Returns an aggregate summary across your published posts, plus a per-network breakdown. All figures reflect what the networks have actually reported — they are 0 until then, never fabricated.

Request

Send the request to GET /api/v1/analytics. Set your key in the environment as POSTMYISH_KEY to run these as-is.

curl https://postmyish.com/api/v1/analytics \
  -H "Authorization: Bearer $POSTMYISH_KEY"

Response

{
  "totalReach": 0,
  "engagementRate": 0,
  "postsPublished": 3,
  "followers": 0,
  "perPlatform": [
    { "platform": "x", "reach": 0, "engagementRate": 0 }
  ]
}

Response fields

totalReachinteger
Summed reach across published posts.
engagementRatenumber
Mean engagement rate (%), rounded to two decimals.
postsPublishedinteger
Number of published posts.
followersinteger
Total followers across connected accounts.
perPlatformarray<object>
Per-network breakdown, highest reach first.
platformstring
The network id.
reachinteger
Reach attributed to this network.
engagementRatenumber
Engagement rate (%) for this network.

Try it

Run this endpoint live with your own key. The key is kept in your browser (local storage) and sent straight to the API — nothing passes through the docs.

Related

How publishing works