Analytics

Followers, daily totals, best times to post and top posts, per profile or per account.

Followers and growth

GET/v1/analytics/followers

Current followers, growth over the period and the daily history of each account. Refreshed once a day.

Parameters

profileIdstringrequired
accountIdstring
Only this account; the whole profile otherwise.
fromstring
First day (YYYY-MM-DD). Defaults to 30 days ago.
tostring
Last day (YYYY-MM-DD). Defaults to today.

Response 200

data []

accountIdstringrequired
platformstringrequired
usernamestring
followersintegerrequired
max 9,007,199,254,740,991
growthintegerrequired
Change over the period.
max 9,007,199,254,740,991
growthPercentnumberrequired
historyobject[]required
history
- datestringrequired
  YYYY-MM-DD
- followersintegerrequired
  max 9,007,199,254,740,991

curl "https://api.usecrier.com/v1/analytics/followers" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/analytics/followers', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/analytics/followers",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Daily totals

GET/v1/analytics/daily

Posts and engagement per day (counted on the day it arrived), and totals per network.

Parameters

profileIdstringrequired
accountIdstring
Only this account; the whole profile otherwise.
fromstring
First day (YYYY-MM-DD). Defaults to 30 days ago.
tostring
Last day (YYYY-MM-DD). Defaults to today.

Response 200

data

daysobject[]required
days
- datestringrequired
  YYYY-MM-DD
- postsintegerrequired
  max 9,007,199,254,740,991
- metricsobjectrequired
  metrics
  - impressionsintegerrequired
    max 9,007,199,254,740,991
  - reachintegerrequired
    max 9,007,199,254,740,991
  - viewsintegerrequired
    max 9,007,199,254,740,991
  - likesintegerrequired
    max 9,007,199,254,740,991
  - commentsintegerrequired
    max 9,007,199,254,740,991
  - sharesintegerrequired
    max 9,007,199,254,740,991
  - savesintegerrequired
    max 9,007,199,254,740,991
  - clicksintegerrequired
    max 9,007,199,254,740,991
  - engagementRatenumberrequired
    Percentage: interactions over impressions (or reach).
byPlatformobject[]required
byPlatform
- platformstringrequired
- postsintegerrequired
  max 9,007,199,254,740,991
- metricsobjectrequired
  metrics
  - impressionsintegerrequired
    max 9,007,199,254,740,991
  - reachintegerrequired
    max 9,007,199,254,740,991
  - viewsintegerrequired
    max 9,007,199,254,740,991
  - likesintegerrequired
    max 9,007,199,254,740,991
  - commentsintegerrequired
    max 9,007,199,254,740,991
  - sharesintegerrequired
    max 9,007,199,254,740,991
  - savesintegerrequired
    max 9,007,199,254,740,991
  - clicksintegerrequired
    max 9,007,199,254,740,991
  - engagementRatenumberrequired
    Percentage: interactions over impressions (or reach).

curl "https://api.usecrier.com/v1/analytics/daily" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/analytics/daily', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/analytics/daily",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Best times to post

GET/v1/analytics/best-times

Average engagement per weekday and hour, from the account’s published posts.

Parameters

profileIdstringrequired
accountIdstring
Only this account; the whole profile otherwise.

Response 200

data []

dayOfWeekintegerrequired
0 = Sunday … 6 = Saturday
max 9,007,199,254,740,991
hourintegerrequired
Hour in UTC
max 9,007,199,254,740,991
avgEngagementnumberrequired
postsintegerrequired
max 9,007,199,254,740,991

curl "https://api.usecrier.com/v1/analytics/best-times" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/analytics/best-times', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/analytics/best-times",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]

Top posts

GET/v1/analytics/top-posts

Posts of the period by engagement (or date), including those published outside Crier.

Parameters

profileIdstringrequired
accountIdstring
Only this account; the whole profile otherwise.
fromstring
First day (YYYY-MM-DD). Defaults to 30 days ago.
tostring
Last day (YYYY-MM-DD). Defaults to today.
sortBystring
Values: engagement · date
limitinteger
max 50

Response 200

data []

postIdstring | nullrequired
The Crier post, when it was published through Crier.
accountIdstring | nullrequired
platformstringrequired
contentstringrequired
publishedAtstring (date-time)
urlstring (uri)
thumbnailUrlstring (uri)
metricsobjectrequired
metrics
- impressionsintegerrequired
  max 9,007,199,254,740,991
- reachintegerrequired
  max 9,007,199,254,740,991
- viewsintegerrequired
  max 9,007,199,254,740,991
- likesintegerrequired
  max 9,007,199,254,740,991
- commentsintegerrequired
  max 9,007,199,254,740,991
- sharesintegerrequired
  max 9,007,199,254,740,991
- savesintegerrequired
  max 9,007,199,254,740,991
- clicksintegerrequired
  max 9,007,199,254,740,991
- engagementRatenumberrequired
  Percentage: interactions over impressions (or reach).
externalbooleanrequired
Published outside Crier.

curl "https://api.usecrier.com/v1/analytics/top-posts" \
  -H "Authorization: Bearer $CRIER_API_KEY"

const res = await fetch('https://api.usecrier.com/v1/analytics/top-posts', {
  headers: {
    Authorization: `Bearer ${process.env.CRIER_API_KEY}`,
  },
});
const { data } = await res.json();

import os, requests

res = requests.get(
    "https://api.usecrier.com/v1/analytics/top-posts",
    headers={"Authorization": f"Bearer {os.environ['CRIER_API_KEY']}"},
)
data = res.json()["data"]