Posttar API

Reports

What was published in a period, and how each post performed.

Two endpoints, and they answer different questions. GET /projects/:id/reports/summary counts what exists. GET /projects/:id/reports/performance lists each post with its metrics.

The summary, for a project with nothing published yet:

{
  "period": { "from": null, "to": null },
  "published": 0,
  "scheduled": 0,
  "drafts": 21,
  "publishedWithoutMetrics": 0,
  "publishedWithoutDate": 0
}

Both take from and to as ISO dates. Without them the whole history is considered.

Posts with no metrics

publishedWithoutMetrics and the withoutMetrics list are not a bug in the report: they are posts that were published but whose Instagram metrics were never collected. A post published outside Posttar, or published before the account was connected, lands there.

performance is one of the three listings that take a cursor. With a long history, read it page by page using the next field.