Skip to main content

AccountAnalytics

account objectrequired
idintegerrequired
uuidstring<uuid>required
namestringrequired
Example: My Instagram
usernamestringrequired
Example: myhandle
imagestring<uri>nullable
providerstringrequired

Possible values: [instagram, tiktok, pinterest, twitter, linkedin, facebook_page, youtube, mastodon]

dataobjectrequired

Provider-specific metadata.

authorizedbooleanrequired
profile_urlstring<uri>nullable

Public URL of the account's profile on the network, when known.

publish_statusstring

Only present when the account is embedded in a post. Publishing state of this account for the post.

Possible values: [pending, publishing, published, failed]

published_partsinteger

Only present when the account is embedded in a post. How many parts (for example thread items or a first comment) are live on the network.

Possible values: >= 0

external_urlstring | nullnullable

Only present when the account is embedded in a post. URL of the published post on the network, null until it is live.

errors object[]

Only present when the account is embedded in a post. Why publishing to this account failed. A raw network error is stored as two entries: a readable line ("<Network>: <message> (code <code>)") and an object {platform, code, message, raw} with the network's original response in raw. Other failures are a single readable string.

  • Array [
    • oneOf
    string
  • ]
    • created_atstringrequired

    UTC, formatted Y-m-d H:i:s.

    Example: 2026-10-11 09:30:00
    typestringrequired

    The analytics tab returned.

    tabsstring[]required

    Tabs this account supports; any of them can be passed as type.

    period objectrequired
    start_datestring<date>required
    end_datestring<date>required
    previous_start_datestring<date>required

    Start of the equally long range before this one, used for comparisons.

    previous_end_datestring<date>required
    initial_sync objectrequired
    in_progressbooleanrequired
    progressnullable

    Sync progress while the first analytics import runs.

    data objectrequired

    Provider- and tab-specific metrics. Chart series are lists of {date, value} points.

    property name*any

    Provider- and tab-specific metrics. Chart series are lists of {date, value} points.

    AccountAnalytics
    {
      "account": {
        "id": 0,
        "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "My Instagram",
        "username": "myhandle",
        "image": "string",
        "provider": "instagram",
        "data": {},
        "authorized": true,
        "profile_url": "string",
        "publish_status": "pending",
        "published_parts": 0,
        "external_url": "string",
        "errors": [
          "string",
          {
            "platform": "string",
            "code": "string",
            "message": "string"
          }
        ],
        "created_at": "2026-10-11 09:30:00"
      },
      "type": "string",
      "tabs": [
        "string"
      ],
      "period": {
        "start_date": "2024-07-29",
        "end_date": "2024-07-29",
        "previous_start_date": "2024-07-29",
        "previous_end_date": "2024-07-29"
      },
      "initial_sync": {
        "in_progress": true
      },
      "data": {}
    }