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.

You will receive an API key from Agility, which is required for every request.

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.

There are limits on how many requests you can make per minute, hour, or day to ensure system performance.

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

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.

To begin using the Media Intelligence API:

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