Substy Developers
Analytics

Get creator performance statistics

Read creator performance over a date range with daily, weekly or monthly aggregation. A null creator selects accessible creators; optionally include a creator breakdown. Reporting uses the employee's timezone.

GET/v1/agencies/{agencyId}/analytics/earnings

Read creator performance over a date range with daily, weekly or monthly aggregation. A null creator selects accessible creators; optionally include a creator breakdown. Reporting uses the employee's timezone.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length

Query Parameters

creatorId*string|null
startDate*string
endDate*string
granularity?string
Default"daily"

Value in

  • "daily"
  • "weekly"
  • "monthly"
breakdownByCreator?boolean
Defaultfalse

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/agencies/string/analytics/earnings?creatorId=string&startDate=string&endDate=string" \  -H "Authorization: Bearer YOUR_API_KEY"
{  "data": {    "creatorBreakdown": null,    "beingTalkedTo": 0,    "earnings": {      "chartAmount": [        {          "date": "string",          "count": 0        }      ],      "delta": 0,      "total": 0,      "totalGross": 0    },    "averagePpvPaid": {      "total": 0,      "delta": 0,      "chartData": [        {          "date": "string",          "count": 0        }      ]    },    "revenueByAi": {      "total": 0,      "delta": 0,      "chartData": [        {          "date": "string",          "count": 0        }      ]    },    "revenueByOthers": {      "total": 0,      "delta": 0,      "chartData": [        {          "date": "string",          "count": 0        }      ]    },    "newFans": {      "delta": 0,      "subscribers": 0,      "subscribes": [        {          "date": "string",          "count": 0        }      ]    },    "fans": {      "delta": 0,      "subscribers": 0,      "subscribes": [        {          "date": "string",          "count": 0        }      ]    },    "revenueByNewFans": 0,    "revenueByExistingFans": 0,    "ppvSent": {      "total": 0,      "delta": 0,      "chartData": [        {          "date": "string",          "count": 0        }      ]    },    "ppvPaid": {      "total": 0,      "delta": 0,      "chartData": [        {          "date": "string",          "count": 0        }      ]    },    "unlockRate": {      "total": 0,      "delta": 0,      "chartData": [        {          "date": "string",          "count": 0        }      ]    },    "ltv": {      "total": 0,      "delta": 0,      "chartData": [        {          "date": "string",          "count": 0        }      ]    },    "totalMessageSent": {      "total": 0,      "delta": 0,      "chartData": [        {          "date": "string",          "count": 0        }      ]    },    "goldenRatio": {      "total": 0,      "delta": 0,      "chartData": [        {          "date": "string",          "count": 0        }      ]    },    "subscriptionEarning": {      "chartAmount": [        {          "date": "string",          "count": 0        }      ],      "delta": 0,      "total": 0,      "totalGross": 0    },    "postsEarning": {      "chartAmount": [        {          "date": "string",          "count": 0        }      ],      "delta": 0,      "total": 0,      "totalGross": 0    },    "messagesEarning": {      "chartAmount": [        {          "date": "string",          "count": 0        }      ],      "delta": 0,      "total": 0,      "totalGross": 0    },    "tipsEarning": {      "chartAmount": [        {          "date": "string",          "count": 0        }      ],      "delta": 0,      "total": 0,      "totalGross": 0    },    "referralsEarning": {      "chartAmount": [        {          "date": "string",          "count": 0        }      ],      "delta": 0,      "total": 0,      "totalGross": 0    },    "streamsEarning": {      "chartAmount": [        {          "date": "string",          "count": 0        }      ],      "delta": 0,      "total": 0,      "totalGross": 0    }  },  "meta": {    "requestId": "string"  }}