API Units
Each Zoho Analytics API method has been associated with a defined quantum of units. The units consumed by your application will be calculated based on how often the different API methods are invoked in your application on a per day basis.
Each Zoho Analytics pricing plan will be capped with an allowed units per day. The limits will be applied based on your Zoho Analytics plan. You can also purchase add-on units on need.
PRICING PLANS AND API UNITS ALLOWED PER DAY:
| Plan | API Units per Day |
|---|---|
| Free | 1,000 units |
| Basic | 4,000 units |
| Standard | 10,000 units |
| Premium | 30,000 units |
| Enterprise | 100,000 units |
For example, a user account in Zoho Analytics Standard plan, can only consume a maximum of 10,000 API units per day.
UNITS CALCULATION FOR EACH API METHOD/ACTION
The table below provides how many units will be consumed invoking each of the different types of API methods
| API Description | API Action | Units |
|---|---|---|
| API Type - BULK | ||
| Import using APPEND option | 10 units per 1000 Rows | |
| Import using TRUCATEADD option | 10 units per 1000 Rows | |
| Import using UPDATEADD option | 15 units per 1000 Rows | |
| Export Chart View in Image or PDF format | 10 units per request | |
| Export any view as PDF | 5 units per 1000 Rows | |
| Export Dashboard in any format | 15 units per request | |
| Export any view as HTML | 15 units per request | |
| All the other Export operations (not comes under the above EXPORT classifications) Examples: 1. Exporting a Table in CSV format 2. Exporting a Pivot View in JSON format etc. | 3 units per 1000 Rows | |
| Copying a Workspace without Data | 25 units per request | |
| Copying a Workspace with Data | 25 units per request + 1 unit per 1000 Rows | |
| API Type - DML | ||
| Add a single row | 0.1 unit per request | |
| Update rows | 0.3 unit per request | |
| Delete rows | 0.1 unit per request | |
| API Type - METADATA | ||
| Get details of an import job | 0 units per request | |
| Get details of an export job | Get Export Job Details | 0 units per request |
| Download data for the export job | 0 units per request | |
| Create a blank workspace | 1 unit per request | |
| Rename a workspace | 1 unit per request | |
| Delete a workspace | 1 unit per request | |
| Create a new table | 1 unit per request | |
| Copy a view within the workspace | 1 unit per request | |
| Rename a view | 1 unit per request | |
| Delete a view | 2 units per request | |
| Create a new folder | 1 unit per request | |
| Rename a folder | 1 unit per request | |
| Set default folder | 1 unit per request | |
| Delete a folder | 1 unit per request | |
| Add a new column | 15 units per request | |
| Rename a column | 5 units per request | |
| Delete a column | 10 units per request | |
| Add a lookup in child table | 1 unit per request | |
| Remove lookup from a column | 2 units per request | |
| Hide the columns | 1 unit per request | |
| Unhide the hidden columns | 1 unit per request | |
| Copy views from one workspace to another | 1 unit per request | |
| Copy formulas from one table to another | 1 unit per request | |
| Create reports for table based on the reference table. | 1 unit per request | |
| Auto generate reports for the table. | 1 unit per request | |
| Auto generate reports for the column | 1 unit per request | |
| Get list of admins for a workspace | 1 unit per request | |
| Get details of a variable | 1 unit per request | |
| Create a new variable | 1 unit per request | |
| Update details of a variable | 1 unit per request | |
| Delete a variable | 1 unit per request | |
| Get all accessible organizations | 0.1 unit per request | |
| Get all accessible workspaces | 0.2 unit per request | |
| Get list of owned workspaces | 0.1 unit per request | |
| Get list of shared workspaces | 0.1 unit per request | |
| Get all accessible view list from a workspace | 0.1 unit per request | |
| Get all accessible folder list from a workspace | 0.1 unit per request | |
| Get list of recently accessed views | 0.1 unit per request | |
| Get list of all accessible dashboards | 1 unit per request | |
| Get list of owned dashboards | 0.1 unit per request | |
| Get list of shared dashboards | 0.5 unit per request | |
| Get secret key of a workspace | 0.5 unit per request | |
| Get details of a workspace | 0.1 unit per request | |
| Get details of a view | 0.1 unit per request | |
| Add a workspace as favorite | 0.1 unit per request | |
| Remove a workspace from favorite | 0.1 unit per request | |
| Add a workspace as favorite | 0.1 unit per request | |
| Remove a view from favorite | 0.1 unit per request | |
| Add a workspace as default | 0.1 unit per request | |
| Remove a workspace from default | 0.1 unit per request | |
| Get details of a workspace/view | 0.1 unit per request | |
| Get list of datasources for a workspace | 1 unit per request | |
| Initiate datasync for a connection | 5 unit per request | |
| Initiate datasync for a view | 2 unit per request | |
| Get import details of a view | 0.1 unit per request | |
| Update connection details | 1 unit per request | |
| Enable workspace access for white label domain | 0.1 unit per request | |
| Disable workspace access for white label domain | 0.1 unit per request | |
| Get list of admins for an organization | 0.1 unit per request | |
| Get list of admins for a workspace | 0.1 unit per request | |
| Add admins for a specified workspace | 5 units per request | |
| Remove admins from a workspace | 5 units per request | |
| Get shared details of a workspace | 3 units per request | |
| Share views to users | 5 units per request | |
| Remove shared views for users | 5 units per request | |
| Get permissions for a view | 0.1 unit per request | |
| Get list of groups from a workspace | 0.1 unit per request | |
| Get details of a group | 0.1 unit per request | |
| Create a new group | 1 unit per request | |
| Rename a group | 0.1 unit per request | |
| Add users to a group | 0.1 unit per request | |
| Remove users from a group | 0.1 unit per request | |
| Delete a group | 1 unit per request | |
| Get URL to access a view | 0.1 unit per request | |
| Get embed URL to access a view | 1 unit per request | |
| Get private URL to access a view | 0.1 unit per request | |
| Create private URL for a view | 1 unit per request | |
| Get list of all slideshows in a workspace | 1 unit per request | |
| Get details of a slide | 1 unit per request | |
| Get URL to access a slideshow | 1 unit per request | |
| Create a new slideshow. | 2 units per request | |
| Update details of a slideshow | 2 units per request | |
| Delete a slideshow | 2 units per request | |
| Get list of users in an organization | 1 unit per request | |
| Add users in an organization | 0.1 unit per request | |
| Remove users from an organization | 0.1 unit per request | |
| Activate users in an organization | 0.1 unit per request | |
| Deactivate users in an organization | 0.1 unit per request | |
| Change role of the users in an organization | 0.1 unit per request | |
| Get subscription details of an organization | 0.1 unit per request | |
For example, making a “IMPORT” API (Import APPEND Type) call to import 10,000 rows the units consumed will be: (10,000/1,000) * 10 units = 100 units consumed.
Note: When the total API Units consumed per day exceeds the allowed units for the purchased plan, Zoho Analytics will send the error response with code 6043 (or) 6044.