Monthly plans for the Stream Feeds product is billed based on three main metrics - Updates, API calls, and unique records that we store. Here is a quick breakdown of these.
Updates are a unique concept to the Stream Feeds product that is related to the number of feeds that are "updated" for an action in the Feeds API. One example would be to consider adding a single activity to a feed that is followed by n other feeds. In the below example, feed A is followed by three other feeds, so the act of adding content to this feed constitutes 4 updates and 1 API call.
2. API Calls
// not an API call
const feed = streamClient.feed("user", "steve");
// API call to fetch feeds content
const results = await feed.get();
3. Unique Records
Unique Records are calculated as the sum of Follows and Activities.
4. Concurrent Connections
Each feeds plan also includes an allocated number of concurrent connections. Although these aren't included in overages, if you are consistently exceeding this limit, you will be asked to upgrade your plan.
What happens if I exceed my Feed plan limits?
If your organization exceeds your monthly API call limit, Stream is alerted and a team member will send out an email to notify you of the exception and give you the ability to upgrade your plan. If no action is taken by you to respond or upgrade your plan, the rate limiter will turn on to get your total number of calls under the limit for your plan.
Overage on updates adds overage fees to your charges for that month. If your organization is on the free plan and exceeds monthly updates, you will receive an email notifying you of the need to upgrade to a paid plan. If the organization isn't upgraded it will be suspended.