X Ads campaign reach

Get reach and average-frequency metrics for campaigns Native X fields and pagination are preserved; monetary fields ending in _micro are millionths. Works on your own X Ads account, connected through Get MCP Ads. Needs account id, campaign ids, end time and more.

Inputs

4 required

Account ID: X Ads account ID selected in SourcesRequired · account_id
Campaign IDs: Comma-separated campaign IDs to fetch reach for (max 20)Required · campaign_ids
End time: ISO 8601 end of the metrics window (exclusive); must be in the past (a future end_time is rejected)Required · end_time
Start time: ISO 8601 start of the metrics windowRequired · start_time
Workspace ID: Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Pricing

Price: $0.005 per call
Billing: The provider’s price, with no markup. Billed for measured usage.

Call

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call
cURL command
TypeScript
Tool ID

Alternatives

X Ads reporting

Connect your agent to 2,400+ tools for free

Get $5 free credit Get $5 free credit