List Audience Segments

List Google Ads audience segments by type with optional name search and result limit. Supports: USER_LIST, AFFINITY, IN_MARKET, LIFE_EVENT, DETAILED_DEMOGRAPHICS, CUSTOM_AUDIENCE, COMBINED_AUDIENCE, AUDIENCE (reusable Audience entities used as PMax/Demand Gen signals), or ALL. To upload Customer Match members, use data_manager_ingest_audience_members with a Google Data Manager connection.


App	Google Ads
Operation ID	`gads_list_audience_segments`
Type	Action
Connection	`gads` (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`account`	GadsAccountItem or object or array of object or string or integer	Yes	-	Select the Google Ads account, ask user for it if not provided
`segment_type`	string or SelectableOption	No	-	Audience segment type to list as per the Enum AudienceSegmentType. Note: ‘AUDIENCE’ is reusable Audience entities used as PMax/Demand Gen signals.
`search_term`	string	No	-	Optional search term to filter audience names
`limit`	integer	No	-	Maximum number of segments to return

GadsAccountItem

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-
`managerId`	string	Yes	-	The manager ID for the Google Ads account. Ask user to use the dropdown to select accounts, this manager id is selected background and not shown to the user.

SelectableOption

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

Output

Type: List[Dict] Returns audience segments. Fields: type, id, name, resource_name

Get Started

Guides

Operations

List Audience Segments

Inputs

GadsAccountItem

SelectableOption

Output

​Inputs

​GadsAccountItem

​SelectableOption

​Output

Inputs

GadsAccountItem

SelectableOption

Output