Project engagement roll-up

Post/delivery counts, metric totals, and a per-platform breakdown over the window. "How are we doing?" in one call. Optionally sliced to one platform and/or one format (feed post / reel / story).

Every answer carries coverage, which says why an empty answer is empty. deliveries is what went out in the window, and the three counts under it PARTITION it — with_metrics + unreportable + awaiting === deliveries, always: with_metrics is what the totals could be built from, unreportable has no numbers and never will (deleted, expired, or a kind of post the platform never reports on), awaiting is simply not in yet. unsupported is a SUBSET of unreportable, not a fourth bucket: deliveries nobody will ever report on — stories, which Instagram and Facebook report nothing about, ever. So format=story returns zero totals however many stories went out; read coverage.unsupported before calling a window quiet. ever_delivered ignores the window and every filter, and separates "nothing here" from "nothing ever".

get/insights

Request

  • Base URL: https://xpost.to/api/v1
  • URL: https://xpost.to/api/v1/insights
  • Auth: HTTP bearer

Query parameters

since_daysinteger
platformstring
format'feed' | 'reel' | 'story'

Response

Roll-up

postsinteger
deliveriesinteger
totalsobject

Changes

No recorded changes to this operation across all 1 revision of this API.