Docs menu
Get started
What is Opus GrowthQuickstartAdd to your AIHow it worksSafety and approvalCreditsPlansFAQAI apps
All AI appsChatGPTClaudeGrokPerplexityClaude CodeCodexGemini CLIOpenClawCursorVS CodeWindsurfOther MCPConnect ad platforms
Google AdsMeta AdsLinkedIn AdsMicrosoft AdvertisingTikTok AdsChatGPT AdsAgencies and MCCConnect data sources
Search ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWebsites and SEO
AI ServerWordPressSEO IntelligenceClick fraudTool reference
All toolsGoogle AdsMeta AdsTikTok AdsLinkedIn AdsMicrosoft AdvertisingChatGPT AdsSearch ConsoleGoogle AnalyticsYouTubeBusiness ProfileTag ManagerWordPressAI ServerSEO IntelligenceClick fraudCross-channelAccount and billingLanguage
List Audiences
Lists the account's audiences (remarketing / rule-based / customer-match / lookalike): id, name, type, membership status, membership duration (days), Display/Search network size.
- Type
- Reads only
- Credits
- 1
- Platform
- Google Ads
- Approval
- Not needed, nothing changes
What it does
Lists the account's audiences (remarketing / rule-based / customer-match / lookalike): id, name, type, membership status, membership duration (days), Display/Search network size.
definition=true also returns WHAT DEFINES each list, which the name alone does not tell you and which you need before attaching or — far more dangerous — EXCLUDING one: for a RULE_BASED list the URL/event rule items with their operators and lookback window; for a LOGICAL/COMBINED list the constituent lists resolved to NAMES with their ANY/ALL/NONE operator; for a SIMILAR list the seed list; for CRM_BASED the upload key and data source. Excluding a list that turns out to be "anyone who reached any thank-you page" silently suppresses real prospects, so check the rule rather than trusting the name. Google does NOT store a readable rule for every list — older ones come back with definition_available=false, and then the Google Ads interface (Tools, Audience manager) is the only place to read it. Every audience is retained: limit controls only this response page and page_token continues from cache without a new query or credit. Read-only.
MCP: list_audiences
How to use it
You don't call tools by name. Write what you want in ChatGPT, Claude or another assistant connected to Opus Growth, in your own words; it picks this tool when it fits.
Parameters
| Name | Type | Required | Default | |
|---|---|---|---|---|
| customer_id | string | Required | · | Google Ads customer account ID to query or change. Use the numeric ID returned by list_accounts; omit separators unless this tool explicitly says otherwise. |
| limit | integer | Optional | 0 | Maximum number of rows returned in this response. When the result has_more flag is true, continue with next_page_token rather than assuming the list is complete. |
| definition | boolean | Optional | false | Whether to enable definition for this operation. |
| page_token | string | Optional | · | Continuation token returned as next_page_token by a previous call. Leave empty for the first page; pass it unchanged to retrieve the cached next page. |
Related tools
account_auditAccount Snapshotaccount_snapshotAdd Keywordsadd_keywordsAdd Negative Keywordadd_negative_keywordAdd PMax Imagesadd_pmax_imagesApply Recommendationapply_recommendationBudget Pacing Alertsbudget_pacing_alertsCompetitor Adscompetitor_adsConnect Business Profileconnect_business_profile