---
title: "performance_metrics. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/performance_metrics
description: "Granular performance metrics for ads, audiences, creatives, offers, target groups, keywords. Read tool on the Metadata MCP server, with its full JSON Schema and a real recorded response."
source: metadata.io
---

# performance_metrics

Granular performance metrics for ads, audiences, creatives, offers, target groups, keywords.

Read [analytics](https://metadata.io/developers/tools/#cat-analytics)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `launchedExperimentStatuses` | array |   | Filter Performance Metrics by experiment launch statuses only. |
| `page` | integer |   | Page number to retrieve (0-based indexing) |
| `size` | integer |   | Number of results per page. Default 100; raise it freely (up to 10000) for comprehensive full-dataset analysis. |
| `sort` | string |   | Sorting criteria (e.g., 'spent,desc', 'cpl,asc', 'experimentId,spent,desc') |
| `ids` | array |   | Set of IDs to filter by |
| `experimentIds` | array |   | Set of experiment IDs to filter by |
| `startDate` | string |   | startDate in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ), e.g., `startDate=2025-06-12T14:30:00.123Z`). |
| `endDate` | string |   | endDate in ISO 8601 format (YYYY-MM-DDThh:mm:ssZ), e.g., `startDate=2025-06-12T14:30:00.123Z`). |
| `oppsStartDate` | string |   | Start date for opportunities data in ISO 8601 format |
| `oppsEndDate` | string |   | End date for opportunities data in ISO 8601 format |
| `adName` | string |   | Filter by specific ad name |
| `keyword` | string |   | Filter by specific keyword |
| `campaignName` | string |   | Filter by specific campaign name |
| `creativeName` | string |   | Filter by specific creative name |
| `customAudienceName` | string |   | Filter by specific custom audience name |
| `offerName` | string |   | Filter by specific offer name |
| `experimentName` | string |   | Filter by specific experiment name |
| `budgetGroupName` | string |   | Filter by specific budget group name |
| `channels` | array |   | Filter by marketing channels |
| `goals` | array |   | Filter by campaign goals |
| `audienceTypes` | array |   | Filter by audience types |
| `offerTypes` | array |   | Filter by offer types. LG=Lead Gen forms, LP=Landing Pages |
| `visibilities` | array |   | Filter by visibility status |
| `adFormats` | array |   | Filter by ad format types. Applied to ads endpoint automatically. |
| `minSpend` | number |   | Minimum spend threshold |
| `maxSpend` | number |   | Maximum spend threshold |
| `minLeads` | integer |   | Minimum number of leads threshold |
| `maxLeads` | integer |   | Maximum number of leads threshold |
| `minCpl` | number |   | Minimum cost per lead threshold |
| `maxCpl` | number |   | Maximum cost per lead threshold |
| `minAudienceSize` | integer |   | Minimum audience size threshold |
| `maxAudienceSize` | integer |   | Maximum audience size threshold |
| `usedInActiveExperiments` | boolean |   | Filter for ingredients used in active experiments only |
| `tags` | array |   | Set of tag IDs to filter by |
| `accountTagIds` | array |   | Set of account tag IDs to filter by |
| `showWithSpend` | boolean |   | Show only experiments/ingredients with spend data |
| `experimentList` | string |   | Experiment list filter |
| `customFieldIds` | string |   | Custom field IDs to include |
| `skipCustomFields` | boolean |   | Skip custom fields in response |
| `endpoint` | string |   | Specific endpoint to query. If not specified, will be auto-determined from query context. Use 'customAudience/group' for target groups.one of: `ads`, `customAudience`, `customAudience/group`, `offer`, `creative`, `keywords` |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

Real, from the production server, in **1561 ms**. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

## Related

Other analytics tools:

- [account_funnel_reports](https://metadata.io/developers/tools/account_funnel_reports) Read
- [account_level_stats](https://metadata.io/developers/tools/account_level_stats) Read
- [account_list_performance](https://metadata.io/developers/tools/account_list_performance) Read
- [budget_group_performance](https://metadata.io/developers/tools/budget_group_performance) Read
- [deep_funnel_stats](https://metadata.io/developers/tools/deep_funnel_stats) Read
- [demographic_country_stats](https://metadata.io/developers/tools/demographic_country_stats) Read
- [experiment_performance_stats](https://metadata.io/developers/tools/experiment_performance_stats) Read
- [get_account_opportunities_insights](https://metadata.io/developers/tools/get_account_opportunities_insights) Read

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)