Get analytics history

Returns snapshot-based timeseries, platform breakdown, top content, and insights for a date range.

Required permission: `analytics:read`

Accepts `profileId` to target a specific profile. Omit it to use the key’s home profile.

GET/v1/analytics/historyanalytics:read

Request

Authorization

Send your API key as a Bearer token in the Authorization header.

Query parameters

profileIdstringoptional

Profile to act on. Defaults to the profile the API key was created in.

fromstringoptional

Start date (YYYY-MM-DD). Defaults to 28 days ago.

tostringoptional

End date (YYYY-MM-DD). Defaults to today.

Response

Returns 200.

fromstringrequired

tostringrequired

previousFromstringrequired

previousTostringrequired

snapshotDaysnumberrequired

hasHistorybooleanrequired

objectrequired

timeseriesobject[]required

timeseriesByPlatformobjectrequired

platformsobject[]required

topContentobject[]required

insightsobject[]required

profileIdstringoptional

Errors

Failures use the standard error format.

Status	Code	When it happens
400	invalid_request	The request body or query string failed validation. The message names the offending field.
401	invalid_api_key	The key does not exist, was revoked, or is malformed. Keys start with cdyn_live_.
403	profile_not_accessible	The requested profile is outside this key’s scope, or belongs to another account.
429	rate_limit_exceeded	Too many requests for this key. Honour the Retry-After header before retrying.
500	internal_error	Something failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists.

curl -X GET "https://api.cutedyno.com/v1/analytics/history?profileId=PROFILE_ID" \
  -H "Authorization: Bearer $CUTEDYNO_API_KEY"

200Example response

{
  "profileId": "profile_a1b2c3d4",
  "from": "string",
  "to": "string",
  "previousFrom": "string",
  "previousTo": "string",
  "snapshotDays": 0,
  "hasHistory": false,
  "summary": {
    "views": {
      "value": 0,
      "previousValue": 0,
      "delta": 0,
      "deltaPercent": 0
    },
    "engagement": {
      "value": 0,
      "previousValue": 0,
      "delta": 0,
      "deltaPercent": 0
    },
    "shares": {
      "value": 0,
      "previousValue": 0,
      "delta": 0,
      "deltaPercent": 0
    },
    "followers": {
      "value": 0,
      "previousValue": 0,
      "delta": 0,
      "deltaPercent": 0
    },
    "reach": {
      "value": 0,
      "previousValue": 0,
      "delta": 0,
      "deltaPercent": 0
    },
    "engagementRate": {
      "value": 0,
      "previousValue": 0,
      "delta": 0,
      "deltaPercent": 0
    }
  },
  "timeseries": [
    {}
  ],
  "timeseriesByPlatform": {},
  "platforms": [
    {}
  ],
  "topContent": [
    {}
  ],
  "insights": [
    {}
  ]
}

Base URL: https://api.cutedyno.com

MCP tool: get_analytics_history