What are Bulk API Counts?
Bulk API counts are a billing and analytics metric used to represent the true resource cost of expensive or bulk-nature server operations.
Standard API calls are accrued as a single API count. But some calls do additional processing that goes above and beyond the standard measure - and bulk api counts are used to account for those costs.
Bulk API counts allow finer-grained accounting - and thus are counted via a 10:1 ratio on your API count total. That is, 10 bulk API counts are the equivalent of 1 standard API count. So 2 Bulk API counts are actually 2/10ths of a single API Count.
Bulk API counts are tracked daily per app and contribute to your app's overall usage reporting alongside standard API counts.
How They Are Tracked
Bulk API counts flow through the service operation, which triggers a bulk count publication.
---
Operations That Trigger Bulk API Counts
Admin Operations
Delete All Users — charges 1 bulk op per deleted user
Delete Tester Users — charges 1 bulk op per deleted user
Delete Non-Tester Users — charges 1 bulk op per deleted user
User Purge (background purge utility) — charges +1 bulk op per purged user
App Store / Promotions
Refresh Automated Promotions — charges 10 bulk ops
Authentication
Auto-claim tournament rewards at login — charges 5 bulk ops
Additional locking to prevent session exploits — when enabled, charges 2 bulk ops per authentication. This setting performs extra locking during login to guard against session token exploits at the cost of slightly slower logins.
Custom Entities
GET_PAGE with
doCount=true— charges bulk ops proportional to execution time: elapsed milliseconds ÷ threshold (default 10 ms). A query taking 50 ms would charge 5 bulk ops.Delete Multiple — charges 1 bulk op per deleted entity
Events
Send Event to Multiple Profiles — charges (number of recipients − 1) bulk ops. The first recipient is free; each additional recipient adds 1 bulk op.
Friends
Add Friends From Platform — charges 10 bulk ops
Facebook Limited Login Friend Sync — charges 10 bulk ops
Global App Properties
Create Property — charges 10,000 bulk ops
Update Property — charges 10,000 bulk ops
This high charge reflects the server-wide impact of global property changes, which can affect all players of an app.
Multiplayer Room Servers
GameLift Room Server Ready — charges member count × 100 bulk ops (configurable)
EdgeGap Room Server Ready — charges member count × 50 bulk ops (configurable)
For example, a 4-player lobby launching a EdgeGap server charges 4 × 50 = 200 bulk ops. These charges help cover matchmaking costs when hosting the resulting servers is not on native brainCloud servers.
Tournaments
Post Score — charges 10 bulk ops
Post Score with Results View — charges 10 bulk ops
Get Division Info — charges 10 bulk ops
Group Division Reassessment — charges 10 bulk ops
Tournament Results Processing (background job) — charges 10 × total scores processed