GET https://api.usecommune.com/articles/{article}/stats Production. There is no separate sandbox host.

Retrieve one article's performance

How one article did on both sides at once: what the email did, and what the community did with it afterwards. No email provider can return the right hand column, because the reading, highlighting and arguing happened on Commune.

email is present only for an article Commune sent itself. For an article imported from an outside provider it is null, because that provider mailed it and never handed Commune the per recipient outcome. It is null for an article that has not been sent yet as well.

community is computed at read time and keeps counting long after the send, so two reads a week apart legitimately disagree.

Needs insights: read. The public tallies on an article, likes, comments and highlights, live on the article itself and need only content: read.

Which articles a key can measure depends on whether it acts for the newsletter, which a key does when it holds write in any family. Such a key can measure any of the newsletter's articles, including a draft or one scheduled for later. A key that holds only read permissions can measure exactly the articles getArticle would return to it: sent, already published and not restricted to a tag. Any other article answers 404, the same answer as an id that does not exist, so this operation never confirms that an unpublished article exists. For an article both kinds of key can read, the numbers are the same.

Path parameters

  • string Required

Query parameters

  • string
  • string

Request Headers

  • string
GET /articles/{article}/stats
Loading...

Share your request

Use this link to easily share a pre-filled request of this operation. Everything you filled will be shared apart from the authentication fields.

Request URL

https://api-reference.usecommune.dev/explorer/operation/operation-getarticlestats

Send a delete request

It looks like you’re about to send a DELETE request to this API. This type of request carries a risk of permanent and irreversible data loss.

Are you sure you want to continue?
Response
Waiting for a request to be sent.