Skip to main content
GET
Impressions over time

Authorizations

Authorization
string
header
required

Your API key, sent as Authorization: Bearer <key>. One key manages every profile on the account.

Query Parameters

profile_id
string
required

Id of the brand profile to act on. List them with GET /v1/profiles.

period
string

Named period: last_day, last_week, last_month, last_3months or last_year.

start_date
string

Start of a YYYY-MM-DD range, used instead of period.

end_date
string

End of a YYYY-MM-DD range, used instead of period.

date
string

A single YYYY-MM-DD day.

platform
enum<string>

One channel key.

Available options:
tiktok,
instagram,
linkedin,
youtube,
facebook,
x,
threads,
pinterest,
reddit,
bluesky,
google_business,
telegram,
discord,
slack,
mastodon,
nostr,
lemmy,
devto,
hashnode,
wordpress,
whop,
listmonk
breakdown
string

true to include a per-platform and per-day breakdown.

metrics
string

Comma-separated metrics, e.g. reach,views,likes,comments.

Response

Success.

The response envelope is stable — a profile_id plus the payload — but its inner fields are not yet pinned down in this document.