Media Intelligence API: Overview & How to Use It

The Media Intelligence API allows you to access Agility’s media monitoring data outside of the platform, so you can integrate coverage, insights, and analytics directly into your own tools, dashboards, or workflows.

This article provides a high-level overview of what the API does, when to use it, and how it fits into your PR and communications strategy.

The Media Intelligence API gives you programmatic access to a large dataset of:

Instead of viewing mentions only within the Agility platform, the API lets you retrieve and use that data anywhere, such as internal dashboards, BI tools, or custom applications.

The API is best suited for teams that want to go beyond the standard platform experience.

Pull media coverage into tools like Power BI, Tableau, or internal reporting systems.

Automatically retrieve mentions and generate reports without manual exports.

Combine media data with CRM, marketing platforms, or data warehouses.

Run your own analysis on sentiment, reach, or trends using raw mention data.

Retrieve large volumes of media mentions programmatically instead of relying on manual searches.

The API works by sending requests to Agility’s servers and receiving structured data in return.

API keys are generated from within your Agility account and are required for every request. See the Getting Started section below for details on how to obtain yours.

Define what you are searching for, including date range, source types, and any filters you want to apply.

The API returns a total number of matching mentions and a list of individual mentions with associated metadata.

Run one time searches using keywords or Boolean logic.

Best for quick analysis, exploratory searches, or custom queries.

Retrieve results from saved searches created in the Media Monitoring section of the platform. Best for ongoing monitoring, consistent reporting, and reusing existing search logic.

Retrieve mentions from saved folders, tags, or tag groups created in the platform. Best for working with curated coverage sets and organizing reporting outputs.

Each mention returned by the API can include metadata such as:

The available fields may vary depending on your subscription and data source.

You can refine your results using filters such as:

You can also use standard queries for guided Boolean logic or expert queries for fully custom Boolean expressions.

The data available through the API depends on your Agility subscription.

Usage and Volume API usage is currently monitored on an audit basis. When you agree on a use case with your Agility representative, such as pulling one topic daily, please ensure your integration reflects that. Agility reserves the right to review usage and suspend API access if usage significantly exceeds agreed terms.

Keep your API key secure, do not share it publicly, rotate keys if compromised.

API keys are account-specific. A key generated for one Agility account cannot be used to access data from another account.

Some platforms, such as X, may require additional API calls to retrieve full post content due to platform restrictions.

The Media Intelligence API is ideal if you:

If your focus is viewing mentions, creating briefings, or standard reporting, the Agility platform may already meet your needs without requiring API integration.

Media Intelligence API access is only available for accounts that have been provisioned for API access.

If you do not see the API Keys page, your account may not have API access enabled or your user may not have the required permissions. Contact your Agility representative for assistance.

Before API keys can be created, an Account Administrator must enable Media Intelligence API access for the account.

Click Admin Tools from the top navigation, then select Account Management.

Select the General tab, then check the Media Monitoring APIs box.

Once enabled, users with the API Key Manager permission can create and manage API keys.

Select the Media Monitoring tab.

Scroll to the Media Monitoring APIs section.

Here you can view all API keys that have been created for the account, including:

This page allows Account Administrators to review API keys associated with the account.

Users who need to create and manage API keys must be granted the API Key Manager permission.

This permission allows users to create and manage Media Intelligence API keys within Agility.

Once the API Key Manager permission has been assigned, navigate to:

Content Management → API Keys

Click Create API Key and enter:

After the key is created, it can be used to authenticate requests to the Media Intelligence API.

You can create multiple API keys for different integrations, applications, or environments.

The Swagger documentation provides details on:

This documentation should be used as the primary technical reference when building integrations.

Access the Media Intelligence API Swagger documentation

Start with a simple Topic Search or Ad Hoc Search request to verify that your API key is working correctly and data is being returned as expected.

Once connected, you can begin integrating media monitoring data into:

For setup, access, or integration support, reach out to your Agility account representative or contact support from your dashboard.