Ingage Analytics in the Teams Console gives you a clear view of your team's presentation activity — sessions, page views, button clicks, and more. But what if you want to import that data into a third-party business intelligence tool, your own internal systems, or a custom reporting dashboard? The Ingage Analytics API lets you programmatically pull analytics events so you can work with your data wherever you need it.
This article is intended for technical users (or their engineering teams) who are comfortable working with API keys, environment variables, and Python scripts. If you're looking to view or export analytics without writing code, see Measuring Results with Ingage Analytics or Exporting and Saving Analytics Reports.
Prerequisites
Company Admin access to Ingage (required to create and view API keys)
Python installed on your computer
The requests and pandas Python libraries (or a tool like uv to run scripts with dependencies)
Step 1: Get Your API Key
Before you can call the Ingage API, you need an API key. If you've already created one, you can skip ahead to Step 2.
Log in to the Teams Console at teams.ingage.io
In the left sidebar, click Manage, then select Company
Click the Integrations tab
If you don't already have an API key, click Add API Key and give it a descriptive name
Click View Key to reveal your API key
Copy the key and store it in a safe place
Important: Your API key is private and should be treated like a password. Do not share it in code repositories, emails, or public locations. Store it securely using environment variables or a secrets manager.
For more detail on this step, see Creating an Ingage API Key.
Step 2: Set the API Key as an Environment Variable
Rather than hardcoding your API key into a script, set it as an environment variable on your computer. This keeps the key out of your source code.
On Mac/Linux, open Terminal and run:
export INGAGE_API_KEY="your_api_key_here"
On Windows (Command Prompt), run:
set INGAGE_API_KEY=your_api_key_here
On Windows (PowerShell), run:
$env:INGAGE_API_KEY="your_api_key_here"
Replace your_api_key_here with the actual API key you copied in Step 1.
Step 3: Run the Python Script
With your API key set as an environment variable, you can run a Python script that calls the Ingage Analytics API, retrieves your events, and organizes them into a structured data frame. The script uses the requests library to make API calls and pandas to format the results into a readable table.
If you're using uv (a Python package runner), you can run the script with its dependencies in a single command:
uv run --with requests --with pandas EngagePublicAPI.py
Alternatively, if you have requests and pandas installed in your Python environment, you can run:
python EngagePublicAPI.py
The script will output a pandas DataFrame containing your analytics events. You'll see session data including event types, timestamps, durations, presentation names, page names, and more — the same information you'd see in the Sessions report in the Teams Console, but now available as structured data.
Step 4: Export to CSV (Optional)
The script also supports saving the results as a CSV file, which you can then import into Excel, Google Sheets, a BI tool, or any other system that accepts CSV data. This gives you full flexibility to analyze, transform, and integrate your Ingage analytics data with your existing workflows.
Common Use Cases
Import into a BI tool — Pull analytics events into tools like Tableau, Power BI, or Looker for advanced reporting and visualization beyond what the Teams Console provides
Enrich CRM data — Combine Ingage presentation activity with your CRM records to understand which prospects are engaging with your content
Call coaching integrations — Services like RillaVoice and Siro use the Analytics API to pair call coaching data with Ingage presentation analytics for a richer coaching experience
Automated reporting — Schedule your script to run on a regular basis (e.g., daily or weekly) and automatically export fresh analytics data for internal reporting
Custom dashboards — Build your own internal dashboards that combine Ingage data with metrics from other systems
Things to Know
API keys can be created and managed by Company Admins under Manage > Company > Integrations in the Teams Console
Your API key is private — treat it like a password and never expose it in public code or shared files
The Analytics API returns the same event data visible in the Teams Console, including sessions, presentation views, page views, and button clicks
For questions about API documentation or to coordinate a more complex integration, contact your Ingage Account Manager or reach out to support@ingage.io
For general information about Ingage's public APIs, see the Ingage Product Glossary