--- sourceDocument: Australia Platform Analytics sourceDocumentLink: https://www.servicenow.com/docs/r/australia/now-intelligence Release : - australia ft:locale : - en-US ft:publication_title : - Australia Platform Analytics ft:clusterId : - par bundleId : - par workflow : - Platform --- # Bulk export of Usage Insights data via REST API # Bulk export of Usage Insights data via REST API {#ariaid-title1} Release version: Australia Updated November 5, 2026 ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read Summarize ![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete. ## Summary of Bulk export of Usage Insights data via REST API The Usage Insights data export app enables ServiceNow customers to programmatically export large volumes of Usage Insights data from their instances using an asynchronous REST API. This export is designed for automated, recurring data transfers to enterprise analytics platforms, providing JSON-formatted usage data streamed to a dedicated Kafka topic. Unlike manual exports from the Usage Insights dashboard, this method supports high-volume, scheduled exports with real-time ingestion capabilities. Show full answer Show less ## Key Features * **Asynchronous REST API:** Submit export requests specifying data sources, columns, and filters. Receive an immediate job ID while export processing happens in the background. * **Kafka Integration:** Exported data is streamed in JSON batches to a secure Kafka topic provisioned per instance, allowing seamless real-time data consumption using Kafka clients configured with SSL certificates. * **Designed for Large Volume and Automation:** Supports up to 100 GB per account per month, suitable for programmatic exports driven by scheduled jobs without manual intervention. ## Comparison with Usage Insights Dashboard Export * **Volume:** Dashboard export is suited for small, quick downloads; data export handles large, recurring volumes. * **Frequency:** Dashboard exports are manual; data export is automated via API calls and scheduling. * **Result Format and Delivery:** Dashboard exports files for manual download (CSV/JSON); data export streams JSON batches to Kafka for direct ingestion. * **Processing:** Dashboard export is synchronous; data export is asynchronous. * **Rate Limits:** Up to 60 API requests per hour per instance; results retained on Kafka topic for 36 hours; export requests can cover up to 90 days of data. ## Practical Considerations and Setup * **Request Submission:** Use the REST API to submit export requests with necessary filters and column selections to manage data volume within limits. * **Secure Kafka Connection:** Configure SSL encryption by creating instance-signed certificates and setting up Kafka clients to securely connect to the Hermes-managed Kafka cluster. * **Data Consumption:** Consume JSON data batches from the Kafka topic using standard Kafka clients to integrate Usage Insights data into analytics platforms efficiently and reliably. This capability enables ServiceNow customers to automate and scale usage data exports, supporting comprehensive analytics and integration workflows that require large volumes of usage data delivered in near real-time. Usage Insights data export is a store app that enables you to programmatically export Usage Insights usage data from your ServiceNow® instance for integration with your enterprise analytics platform. ## Overview of Usage Insights data export with REST API {#data-export-restapi__what_is_data_export} Usage Insights data export delivers an asynchronous REST API endpoint that processes export requests in the background and streams results as JSON batches to a dedicated Kafka topic. Unlike manual export from the Usage Insights dashboard, data export is designed for programmatic, large-volume, recurring data movement scenarios. The data export process follows a request-and-response model: 1. You submit an export request to the API, specifying the data source, columns, and optional filters. 2. The instance validates the request and returns a job ID immediately---the data itself is not returned in the API response. 3. The export is processed asynchronously. As results are produced, they are published in batches to a dedicated Kafka topic provisioned for your instance. 4. You consume result batches from the topic using a standard Kafka client, secured with SSL certificates. Note: Usage Insights data export supports events data source. ## Data export compared to Usage Insights dashboard export {#data-export-restapi__data_export_vs_ui_export} The Usage Insights dashboard provides a built-in export function for quick and small-volume data downloads. Bring ServiceNow® usage data into tools like Microsoft Power BI, Tableau, or your enterprise data warehouse so you can analyze it alongside data from other sources. Create end-to-end views of user behavior that spans ServiceNow and other platforms in your technology stack. Data export is a different capability designed for different use cases: {#data-export-restapi__data_export_vs_ui_export__entry__3} | Feature | Usage Insights Dashboard Export | Data Export Store App | |-|-|-| | Volume | Suitable for small-volume, quick exports | Handles large volumes on a recurring schedule (up to 100 GB per account per month) | | Frequency | Manual export triggered by dashboard user | Programmatic export driven by automated API calls and scheduled jobs so that so data flows directly to your analytics infrastructure without manual intervention. | | Result format | Downloaded as CSV or JSON file | Streamed as JSON batches to a Kafka topic | | Integration | User downloads and transfers file manually | Results flow directly into your Kafka consumer environment for real-time ingestion | | Asynchronous processing | Synchronous response; export completes before download | Asynchronous; results arrive on the topic as processing completes | [ ] ## Rate and usage limits {#data-export-restapi__section_xrk_hxx_tjc} {#data-export-restapi__table_jbd_kxx_tjc__entry__3} | Limit | Value | Notes | |-|-|-| | Requests per hour | 60 per instance | Shared across all users and applications on the instance. Additional requests are throttled. | | Result retention | 36 hours | Results remain on the topic for 36 hours. Consume them before they expire. | | Date range per request | Up to 90 days | A single request can't span more than 90 days. | | Monthly export volume | 100 GB per account/ month | Applies per customer account, aggregated across instances, on a calendar-month basis (Base tier). | [ ] {#data-export-restapi__table_jbd_kxx_tjc} Note: Select the columns you need and apply filters to keep export volume within the rate and usage limits. * **[Preparing for the Usage Insights data export via REST API](https://www.servicenow.com/docs/LWv4xqGQTY0ntLXJDUVtJg)** Submit an export request to the Usage Insights data export API to extract usage data asynchronously and consume results from a Kafka topic. * **[Setting up a secure connection to Hermes](https://www.servicenow.com/docs/bnYdM0W8bzwrrWLCgBYsew)** Configure SSL encryption for your Kafka consumers by generating an instance-signed certificate and configuring your Kafka client with SSL to securely connect to the managed Hermes cluster and consume data export results. * **[Consuming data export results](https://www.servicenow.com/docs/L_bFwlh_l8A9M8_Gv_regQ)** Consume the results of usage insights data exported via REST API, from the Kafka topic.