MediaMath

MediaMath Reports API

_

GitHub OpenAPI

Operations 26

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /app_transparency Query the app transparency report · App Transparency #
Ask an LLM
“Which mobile apps did my MediaMath ads actually run in?”
“Can I see spend and impressions broken out by app for a campaign?”
Tell an agent
Pull the app transparency report showing which apps my ads served in.
Show app-level delivery for my campaigns from the app transparency report.
GET /app_transparency/meta Describe the app transparency report fields · App Transparency Meta #
Ask an LLM
“What dimensions and metrics does the app transparency report support?”
“Which fields are required before I query app transparency data?”
Tell an agent
List the fields available in the app transparency report.
Get the metadata for the app transparency report so I know which parameters it needs.
GET /brain_feature_summary/meta Get the Brain feature summary report · Brain Feature Summary report #
Ask an LLM
“How can I see which impression features the Brain weighs most when optimizing?”
“Is there a report that summarizes the Brain's feature importance for a campaign?”
Tell an agent
Pull the Brain feature summary report.
Show me how the Brain's optimization features rank in the feature summary report.
GET /brain_feature_value/meta Get the Brain feature value report · Brain Feature Value report #
Ask an LLM
“Which specific sites, creatives or exchanges push the Brain's predictions up or down most?”
“Can I see the top 100 and bottom 100 feature values affecting Brain predictions?”
Tell an agent
Pull the Brain feature value report with the top and bottom feature values.
Show which individual feature values most help or hurt the Brain's predictions.
GET /by_hour Get hourly performance metrics · By Hour #
Ask an LLM
“Can I get campaign performance down to the hour instead of by day?”
“What were my impressions and spend hour by hour yesterday?”
Tell an agent
Get hourly performance by {dimensions} starting {start_date} for {filter}.
Pull the by-hour report rolled up by {time_rollup} over {time_window} filtered to {filter}.
GET /by_hour/meta Describe the by-hour report fields · By Hour Meta #
Ask an LLM
“Which dimensions can I break the hourly performance report out by?”
“What time windows and rollups does the by-hour report allow?”
Tell an agent
Show the metadata for the by-hour performance report.
Fetch the by-hour report's available dimensions and metrics using session cookie {session_cookie}.
GET /day_part Get performance by time of day and weekday · Day Part #
Ask an LLM
“Which times of day and days of the week perform best for my ads?”
“Can I compare conversions on weekends versus weekdays?”
Tell an agent
Get day-part performance by {dimensions} from {start_date} for {filter}.
Break out performance by hour of day and day of week over {time_window} for {filter}.
GET /day_part/meta Describe the day part report fields · Day Part Meta #
Ask an LLM
“What metrics are available in the day part report?”
“Which intervals does the time-of-day report support?”
Tell an agent
Show the metadata for the day part report.
List the day part report's dimensions and metrics using session cookie {session_cookie}.
GET /deals Get private marketplace deal metrics · Deals #
Ask an LLM
“How many bid opportunities on my private marketplace deals actually turned into won impressions?”
“Can I track the path from biddable to win for a specific deal?”
Tell an agent
Get deal metrics by {dimensions} starting {start_date} for {filter}.
Show biddable-to-win funnel for my PMP deals over {time_window} filtered to {filter}.
GET /deals/meta Describe the deals report fields · Deals Meta #
Ask an LLM
“Which metrics does the deals report expose for PMP deals?”
“What dimensions can I group private marketplace deal data by?”
Tell an agent
Show the metadata for the deals report.
List the deals report fields using session cookie {session_cookie}.
GET /device_technology Get performance by device and browser · Device Technology #
Ask an LLM
“How does my campaign perform across browsers, operating systems and connection types?”
“Can I get device brand and model in the technology report using the v2 version?”
Tell an agent
Get device technology performance by {dimensions} from {start_date} for {filter}.
Break out performance by browser and operating system rolled up by {time_rollup} for {filter}.
GET /device_technology/meta Describe the device technology report fields · Device Technology Meta #
Ask an LLM
“What's the difference between v1 and v2 of the device technology report?”
“Which device fields like brand or model can I report on?”
Tell an agent
Show the metadata for the device technology report.
List device technology report dimensions using session cookie {session_cookie}.
GET /geo Get performance by geography · Geo #
Ask an LLM
“Which countries, regions or metro areas drive the most conversions?”
“Can I see campaign spend split by metro area?”
Tell an agent
Get geo performance by {dimensions} from {start_date} for {filter}.
Break out my campaign results by country and region over {time_window} for {filter}.
GET /geo/meta Describe the geo report fields · Geo Meta #
Ask an LLM
“Which geographic dimensions does the geo report support?”
“What intervals can I pull geographic performance for?”
Tell an agent
Show the metadata for the geo report.
List geo report dimensions and metrics using session cookie {session_cookie}.
GET /performance Get standard campaign performance metrics · Performance #
Ask an LLM
“How do I pull impressions, clicks and spend for my campaigns in campaign currency?”
“Can I aggregate campaign performance by week or month instead of day?”
Tell an agent
Get performance metrics by {dimensions} from {start_date} for {filter}.
Pull the standard performance report rolled up by {time_rollup} over {time_window} for {filter}.
GET /performance/meta Describe the performance report fields · Performance Meta #
Ask an LLM
“Which dimensions and metrics are in the standard performance report?”
“What date ranges and rollups does the performance report allow?”
Tell an agent
Show the metadata for the standard performance report.
List performance report fields using session cookie {session_cookie}.
GET /reach_frequency Get reach and frequency metrics · Reach Frequency #
Ask an LLM
“How many unique users did my ads reach, and how often did each see them?”
“Does seeing an ad more times change click and conversion behavior?”
Tell an agent
Get reach and frequency by {dimensions} from {start_date} for {filter}.
Show unique reach and average frequency over {time_window} for {filter}.
GET /reach_frequency/meta Describe the reach and frequency report fields · Reach Frequency Meta #
Ask an LLM
“Which metrics does the reach and frequency report provide?”
“What windows can unique reach be calculated over?”
Tell an agent
Show the metadata for the reach and frequency report.
List reach and frequency report fields using session cookie {session_cookie}.
GET /site_transparency Get performance by inventory domain · Site Transparency #
Ask an LLM
“Which website domains did my ads run on and how did each perform?”
“Can I find low-performing domains to block?”
Tell an agent
Get site transparency data by {dimensions} from {start_date} for {filter}.
Show performance by domain over {time_window} for {filter}.
GET /site_transparency/meta Describe the site transparency report fields · Site Transparency Meta #
Ask an LLM
“Which fields can I use in the site transparency report?”
“What intervals is domain-level performance available in?”
Tell an agent
Show the metadata for the site transparency report.
List site transparency report fields using session cookie {session_cookie}.
GET /watermark Get Brain learning spend metrics · Watermark #
Ask an LLM
“How much of my spend went toward the Brain's learning activities?”
“Can I see watermark impressions by strategy per day?”
Tell an agent
Get watermark metrics by {dimensions} from {start_date} for {filter}.
Show learning impressions and spend per strategy over {time_window} for {filter}.
GET /watermark/meta Describe the watermark report fields · Watermark Meta #
Ask an LLM
“Which dimensions does the watermark report break learning spend out by?”
“What metrics are in the watermark report?”
Tell an agent
Show the metadata for the watermark report.
List watermark report fields using session cookie {session_cookie}.
GET /win_loss Get auction win/loss metrics · Win Loss #
Ask an LLM
“Why am I losing auctions on certain exchanges or deals?”
“Can I see bid and win rates by strategy and exchange by hour?”
Tell an agent
Get win/loss metrics by {dimensions} from {start_date} for {filter}.
Show auction win rates by strategy and exchange over {time_window} for {filter}.
GET /win_loss/meta Describe the win/loss report fields · Win Loss Meta #
Ask an LLM
“Which strategy, exchange and deal dimensions are in the win/loss report?”
“What auction metrics can the win/loss report return?”
Tell an agent
Show the metadata for the win/loss report.
List win/loss report fields using session cookie {session_cookie}.
GET /win_loss_creative Get auction win/loss metrics by creative · Win/Loss by Creative #
Ask an LLM
“Which of my creatives are losing auctions most often?”
“Can I see hourly win rates broken out by creative?”
Tell an agent
Get win/loss by creative for {dimensions} from {start_date} for {filter}.
Show creative-level auction win rates over {time_window} for {filter}.
GET /win_loss_creative/meta Describe the win/loss by creative report fields · Win/Loss by Creative Meta #
Ask an LLM
“Which creative dimensions does the win/loss by creative report support?”
“What metrics are available when reporting auction losses per creative?”
Tell an agent
Show the metadata for the win/loss by creative report.
List win/loss by creative report fields using session cookie {session_cookie}.

Documentation

📖
Documentation
https://apidocs.mediamath.com/apis/marketplaces-api/marketplaces
📖
Authentication
https://apidocs.mediamath.com/guides
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/mediamath/refs/heads/main/rate-limits/mediamath-rate-limits.yml
📖
Documentation
https://apidocs.mediamath.com/apis/byoa-api/campaign-settings
📖
Documentation
https://apidocs.mediamath.com/
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/mediamath/refs/heads/main/authentication/mediamath-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/mediamath/refs/heads/main/rate-limits/mediamath-rate-limits.yml
📖
Documentation
https://apidocs.mediamath.com/apis/audience-taxonomies
📖
Documentation
https://apidocs.mediamath.com/apis/bof-api-v1
📖
Documentation
https://apidocs.mediamath.com/apis/reporting-api-v1
📖
Documentation
https://apidocs.mediamath.com/apis/video-creatives

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mediamath/refs/heads/main/openapi/mediamath-reports-api-openapi.yml

Other Resources

🔗
Plans
https://raw.githubusercontent.com/api-evangelist/mediamath/refs/heads/main/plans/mediamath-plans.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/mediamath/refs/heads/main/finops/mediamath-finops.yml
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/mediamath/refs/heads/main/plans/mediamath-plans.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mediamath:mediamath-reports-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mediamath-reports-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: ''
  contact:
    name: API Support
    url: https://www.mediamath.com/contact-us/
    email: support@mediamath.com
  title: Reporting API V1 Reports API
  description: '{% admonition type="danger" name="This API is deprecated and will be removed in July 2026" %}

    The new API docs can be found here: https://apidocs.mediamath.com/apis/reporting-api

    {% /admonition %}


    {% admonition type="warning" name="Notice about authentication with cookie adama_session" %}

    The use of cookie adama_session for authentication has been discontinued and it''s not supported in Reporting API V2.'
  license:
    url: http://www.apache.org/licenses/LICENSE-2.0.html
    name: Apache 2.0
servers:
- url: https://api.mediamath.com/reporting/v1/std
tags:


# --- truncated at 32 KB (94 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mediamath/refs/heads/main/openapi/mediamath-reports-api-openapi.yml