XreplyAIDevelopers
API ReferenceAnalytics

Get analytics timeseries

Requires scope: `analytics:read`. Returns a current series and a prior-period comparison series.

GET
/analytics/timeseries

Authorization

ApiKey
AuthorizationBearer <token>

A personal API key created in the dashboard (Starter, Pro, and Team plans).

In: header

Query Parameters

start_date?string

Inclusive start date (YYYY-MM-DD).

Formatdate
end_date?string

Inclusive end date (YYYY-MM-DD).

Formatdate
social_account_id?integer
platform?string

Restrict both series to accounts on a single platform. Aggregates across every account on that platform; composes with social_account_id.

Value in

  • "twitter"
  • "linkedin"
  • "youtube"
  • "instagram"
  • "threads"
  • "pinterest"
  • "tiktok"
  • "bluesky"
  • "mastodon"
  • "facebook"
  • "google_business"
  • "discord"
  • "telegram"
  • "tumblr"
  • "slack"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/analytics/timeseries"
{  "current": [    {      "date": "2026-07-12",      "impressions": 4210,      "engagement_rate": 3.1    }  ],  "comparison": [    {      "date": "2026-06-29",      "impressions": 3800,      "engagement_rate": 2.7    }  ]}

Get analytics rollups GET

Requires scope: `analytics:read`. Returns per-account rollups with period-over-period comparison. The date window selects posts by publish time (falling back to scheduled time, then last-modified, when a post has never been published).

Get best posting times GET

Requires scope: `analytics:read`. Returns day-of-week × hour cells ranked by engagement, plus the single best cell.