---
title: "experiments_keywords_stats. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/experiments_keywords_stats
description: "Keyword performance data from active experiments with date range filtering. Read tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# experiments_keywords_stats

Keyword performance data from active experiments with date range filtering.

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

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `startDate` | string | required | Start date in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). Example: '2025-01-01T00:00:00.000Z' |
| `endDate` | string | required | End date in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). Example: '2025-12-31T23:59:59.999Z' |
| `keywordOrExperimentName` | string |   | Optional substring filter matched against the keyword text and the experiment name. Omit it to get every keyword in the window. |
| `page` | integer |   | Page number for pagination (0-based). Example: page=0 for the first page, page=1 for the next one. |
| `size` | integer |   | Number of keywords per page. Default: 50; raise it (up to 10000) to pull the full keyword set in one call. |
| `sort` | string |   | Sorting criteria as field,direction (direction 'asc' or 'desc'). Sortable fields: keyword, wizExperimentName, adGroup, matchType, status, spend, impressions, clicks, ctr, cpc, cpm, cpl, leads, mqls, cpMQL, conversions, allConversions, interactions, qualityScoreHist, totalOpps, oppsAmount, totalTrigg |

## 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

## Related

Other search tools:

- [add_keywords_to_negative_lists](https://metadata.io/developers/tools/add_keywords_to_negative_lists) Writes
- [add_negative_keyword_lists_to_live_campaigns](https://metadata.io/developers/tools/add_negative_keyword_lists_to_live_campaigns) Writes
- [create_keywords](https://metadata.io/developers/tools/create_keywords) Writes
- [create_negative_keywords_list](https://metadata.io/developers/tools/create_negative_keywords_list) Writes
- [delete_negative_keyword_lists](https://metadata.io/developers/tools/delete_negative_keyword_lists) Destructive
- [duplicate_negative_keywords_list](https://metadata.io/developers/tools/duplicate_negative_keywords_list) Writes
- [get_negative_keywords_list_details](https://metadata.io/developers/tools/get_negative_keywords_list_details) Read
- [list_experiment_keywords](https://metadata.io/developers/tools/list_experiment_keywords) Read

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