Giveaways overview analytics

Get comprehensive analytics for giveaways including participation, entry distribution, winners, and time series data

GET /rewards/stats/giveaways/overview

Giveaways overview analytics

cURL

curl --request GET \
  --url https://{subdomain}.nudj.cx/api/v2/analytics/rewards/stats/giveaways/overview

200

{
  "summary": {
    "totalGiveaways": 123,
    "activeGiveaways": 123,
    "completedGiveaways": 123,
    "totalEntriesDistributed": 123,
    "uniqueParticipants": 123,
    "totalWinners": 123,
    "averageEntriesPerUser": 123,
    "averageWinRate": 123
  },
  "entryDistribution": [
    {
      "source": "<string>",
      "entries": 123,
      "percentage": 123
    }
  ],
  "participationFunnel": [
    {
      "stage": "<string>",
      "count": 123
    }
  ],
  "timeseries": [
    {
      "date": "<string>",
      "newEntries": 123,
      "newParticipants": 123,
      "drawings": 123
    }
  ],
  "popularGiveaways": [
    {
      "rewardId": "<string>",
      "title": "<string>",
      "participants": 123,
      "totalEntries": 123,
      "drawDate": "<string>"
    }
  ]
}

Query Parameters

communityId · string

rewardId · string

startDate · string

endDate · string

status · enum<string> · default: all

Available options: pending, drawn, all

Response

200

application/json

Successful response

summary · object · required

Show child attributes

entryDistribution · object[] · required

Show child attributes

participationFunnel · object[] · required

Show child attributes

timeseries · object[] · required

Show child attributes

popularGiveaways · object[] · required

Show child attributes