You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Update API query pricing: change Plus plan to Analyst plan
* chore: improve formatting for datapoint and credits formula in billing section
* Update billing page with clarified datapoint and spillover calculation section
---------
Co-authored-by: Karim Hassan <[email protected]>
Copy file name to clipboardExpand all lines: api-reference/overview/billing.mdx
+31-4Lines changed: 31 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,10 +17,37 @@ If your execution fails, then no credits are charged. If you execute a query but
17
17
| Queries Endpoint | Available on Plus and Premium |
18
18
| Webhooks (Alerts) | 1 on Free <br></br> 5 on Plus <br></br> 50 on Premium |
19
19
20
-
A datapoint applies to query results after the query is run, and can in most cases be thought of `rows * columns` with an additional limit of 100 avg bytes per cell in a set of results. This can be expressed as:
20
+
A datapoint applies to query results after the query is run, and can in most cases be thought of `rows * columns` with an additional limit of 100 avg bytes per cell in a set of results. This can be expressed as:
When calculating datapoints based on total bytes, cells that exceed 100 bytes will "spill over" into additional cells. Here's how this works:
29
+
30
+
**Example Table:**
31
+
```
32
+
+-----+-----+-----+
33
+
| A1 | B1 | C1 |
34
+
+-----+-----+-----+
35
+
| A2 | B2 | C2 |
36
+
+-----+-----+-----+
37
+
| A3 | B3 | C3 |
38
+
+-----+-----+-----+
24
39
```
25
40
26
-
Any API usage billing will be based on what account the API key is associated with. If you use your team api key to call a public query belonging to yourself, the billing will be associated to the team (and vice versa).
41
+
**Spillover Calculation:** If one cell contains 175 bytes, that cell effectively counts as 2 cells in the datapoint calculation:
42
+
43
+
- First 100 bytes = 1 cell
44
+
- Remaining 75 bytes = 1 additional cell
45
+
46
+
**Example breakdown:**
47
+
- 8 cells of 100 bytes each = 8 cells
48
+
- 1 cell of 175 bytes = 2 cells (100 + 75)
49
+
- Total: 10 cells
50
+
51
+
**API Usage Billing**
52
+
53
+
Any API usage billing will be based on what account the API key is associated with. If you use your team API key to call a public query belonging to yourself, the billing will be associated to the team (and vice versa).
0 commit comments