Get Reach Report

Retrieves total audience reach and average frequency for X Ads campaigns or funding instruments

Retrieves total audience reach and average frequency for X Ads campaigns or funding instruments. These are the only levels X reports true reach at, and they are not available through x_ads_get_report.

App	X Ads
Operation ID	x_ads_get_reach_report
Type	Action
Connection	x_ads (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
account	DynamicAccount	Yes	-	Select the X Ads account to report on.
entity_type	enum (CAMPAIGN, FUNDING_INSTRUMENT)	No	CAMPAIGN	What to measure reach for: CAMPAIGN (default) or FUNDING_INSTRUMENT. Reach and average frequency are only available at these two levels.
entity_ids	string or array of string	Yes	-	Campaign or funding instrument IDs to measure (list or comma-separated, up to 20 per run).
time_range	string or SelectableOption	No	{'value': 'last_7_days', 'label': 'Last 7 days'}	Period to measure: ‘last_7_days’ (default), ‘last_3_days’, ‘today’, or ‘yesterday’. X caps reach windows at 7 days.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: List[Dict]

Returns total_audience_reach and average_frequency per entity.

Fields: dynamic (depend on the inputs)