MMetadata /docs
⌘K
Docs/Tools/demographic_country_stats

demographic_country_stats

Performance metrics grouped by Country.

Read analytics

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

What it does

Performance metrics grouped by Country.

USE FOR: Performance by country/geography, country-level spending/conversions, geographic comparison, international campaign effectiveness, regional ROI/pipeline.
NOT FOR: Account-level aggregates (use account_level_stats), campaign-level details (use experiment_performance_stats), ingredient-level (use performance_metrics).

CHANNELS: FACEBOOK, LINKEDIN, GOOGLE_ADS, INSTAGRAM (comma-separated for multiple)

TIMEFRAME: Supports standard (this/last quarter/month/week/year), period-based (today, yesterday), custom ranges ("last two months", "last 20 days"). ISO 8601 format. Default: current month.

METRICS: spent, impressions, clicks, leads, mqls | ctr, cpl, cpc, cpm, conversionRate, formConversionRate, mqlRate | totalOpps, totalTriggered, oppsAmount, triggeredAmount | cpMql, cpOppInfluenced, cpOppTriggered | channel, lastConvertedDate

Arguments

ArgumentTypeNotes
fromMonth string Start date in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). Example: 2025-01-01T00:00:00.000Z. Required for custom date ranges.
toMonth string End date in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). Example: 2025-01-31T23:59:59.999Z. Required for custom date ranges.
channels string Comma-separated channel names (e.g., 'LINKEDIN,FACEBOOK,INSTAGRAM,GOOGLE_ADS'). Leave empty for all channels.
page integer Page number for pagination (0-based). Example: page=0 for the first page.
size integer Number of results per page. Default: 250; raise it (up to 10000) to pull every country in one call.
sort string Sorting criteria. Examples: 'spend,desc' (default), 'leads,desc', 'cpl,asc', 'impressions,desc'. Format: field,direction where direction is 'asc' or 'desc'.
groupType string Grouping type - currently only COUNTRY is supported for geographic breakdown.
one of: COUNTRY

Request

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":"demographic_country_stats","arguments":{}}}'

Response

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

recorded response
"[value redacted]"

Other analytics tools:

All 160 tools · machine-readable index