MMetadata /docs
⌘K
Docs/Tools/experiments_keywords_stats

experiments_keywords_stats

Keyword performance data from active experiments with date range filtering.

Read search

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Keyword performance data from active experiments with date range filtering.

USE FOR: Keyword performance across experiments, Google Ads / Microsoft Ads keyword metrics/trends, keyword ROI and conversions, search term effectiveness.

REQUIRED: Date range in YYYY-MM-DD to YYYY-MM-DD format.

PAGING: the response is one page: 'totalElements' is the full row count for the window and 'totalPages' the number of pages at the requested 'size'. When totalElements exceeds the rows returned, request the next 'page' (or repeat with a larger 'size') before compiling a keyword list; never report the remaining rows as unavailable.

Arguments

ArgumentTypeNotes
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.

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"experiments_keywords_stats","arguments":{"startDate":"<startDate>","endDate":"<endDate>"}}}'

Response

No recorded response. This tool needs arguments that only exist inside an account, so no response is recorded here. The request is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.

Other search tools:

Browse the tool catalog · machine-readable index