Social Proof Data API | Besitos Knowledge Base

The Social Proof Data API provides aggregate game data about your community, offer activity, and recent earnings from game participation.

Use this data to:

Show how many users are currently earning on your platform
Highlight the total earnings generated by your community
Feature games with recent and ongoing activity
Show how much users have earned from individual games
Highlight recent earnings to demonstrate that users are actively earning

Note: APIs can be used with our iFrame but not with our Wallet solution.

Endpoint

Before you attempt to connect, complete the steps in Prepare to Connect to Besitos APIs.

Endpoint URL	`https://wall.besitos.ai/data/social-proof/aggregate`
HTTP method	GET
Refresh rate	24 hours

No parameters are required, but a valid partner token is required, as with other API endpoints.

Examples

Request

GET https://wall.besitos.ai/data/social-proof/aggregate

Response

{
    "generated_at": "2026-08-13T07:58:04Z",
    "community": {
        "generated_at": "2026-08-13T07:58:04Z",
        "total_users": 320,
        "total_earned_usd": 908.13,
        "active_today": 1
    },
    "offer_activity": {
        "generated_at": "2026-08-13T07:58:04Z",
        "offers": {
            "Amaze GO! - Android": {
                "installs_today": 0,
                "last_install_minutes_ago": null,
                "weekly_installs": 0,
                "weekly_earned_usd": 0,
                "monthly_installs": 0,
                "monthly_earned_usd": 0
            },
            "Go Go Gold Casino - iOS": {
                "installs_today": 0,
                "last_install_minutes_ago": null,
                "weekly_installs": 0,
                "weekly_earned_usd": 0,
                "monthly_installs": 0,
                "monthly_earned_usd": 0
            },
            "Jackpot Nights - iOS": {
                "installs_today": 0,
                "last_install_minutes_ago": null,
                "weekly_installs": 0,
                "weekly_earned_usd": 0,
                "monthly_installs": 0,
                "monthly_earned_usd": 0
            },
            "Mad Lab Wilds - Android": {
                "installs_today": 0,
                "last_install_minutes_ago": null,
                "weekly_installs": 0,
                "weekly_earned_usd": 0,
                "monthly_installs": 0,
                "monthly_earned_usd": 0
            },
            "Toon Blast - Android": {
                "installs_today": 0,
                "last_install_minutes_ago": null,
                "weekly_installs": 0,
                "weekly_earned_usd": 0,
                "monthly_installs": 0,
                "monthly_earned_usd": 0
            }
        }
    },
    "recent_earnings": []
}

Response attributes

All dates and timestamps are returned in EST/EDT.

Attribute	Data Type	Description	Example
Community
`community.generated_at`	string/datetime	The date and time when the community data was generated.	`"2026-08-13T07:58:04Z"`
`community.total_users`	number	The total number of users in your community.	`320`
`community.total_earned_usd`	number	The total earnings generated by your community in USD.	`908.13`
`community.active_today`	number	The number of users who visited your iFrame or clicked a Besitos offer on your platform.	`5`
Offer Activity
`offer_activity.generated_at`	string/datetime	The date and time when the offer activity data was generated.	`"2026-08-13T07:58:04Z"`
`offer_activity.offers`	array	Contains activity and earnings data for each game offer. Offers are identified by name and platform.	`"offers": {` `"Amaze GO! - Android": {` `"installs_today":0,` `"last_install_minutes_ago": null,` `"weekly_installs":0,` `"weekly_earned_usd": 0,` `"monthly_installs": 0,` `"monthly_earned_usd": 0},`
`installs_today`	number	The number of times the offer was installed today.	`2`
`last_install_minutes_ago`	number	The number of minutes since the game was last installed. Returns `null` if the game has not been installed.	`5`
`weekly_installs`	number	The number of times the game was installed in the last 7 days.	`7`
`weekly_earned_usd`	number	The total earnings generated by the game offer in the last 7 days, in USD.	`25.25`
`monthly_installs`	number	The number of times the game was installed in the last 30 days.	`20`
`monthly_earned_usd`	number	The total earnings generated by the offer during the last 30 days, in USD.	`100.50`
`recent_earnings`	number	Contains up to five of the most recent earnings of $5 or more.	`10.50`

Using the response data

Community	Offer activity	Recent earnings
The `community` section provides aggregate information about your user community, including: Total number of users Total earnings in USD Number of currently active users Use this data to show users the size and activity of your community.	The `offer_activity` section provides activity data for up to five offers, prioritized based on recent install activity: Most monthly installs Most weekly installs Most installs today Each offer also includes: Monthly earnings Weekly earnings How many minutes ago the game was last installed Use this data to highlight offers that are currently attracting users and generating earnings.	The `recent_earnings` section provides the five most recent earnings of $5 or more. Use this data to highlight recent earnings activity and show users that others are successfully earning on your platform.