Actions119
- Analyze Search Terms
- Analyze Wasted Spend
- Explain Performance Anomaly
- Get Benchmark Context
- Get Business Profile
- Get Campaign Performance
- Get Campaign Structure
- Get Campaign Targeting
- Get Pmax Audience Signals
- Get Pmax Search Themes
- Get Usage Status
- Help User Upload
- Infer Business Profile
- List Campaign Extensions
- List Campaigns
- Optimize Budget Allocation
- Pause Ad
- Pause Campaign
- Remove Pmax Audience Signal
- Resume Ad
- Resume Campaign
- Save Business Profile
- Search Audiences
- Select Google Campaign Type
- Update Bid Strategy
- Update Campaign
- Update Keyword
- Validate Video
- Analyze Meta Ad Performance
- Analyze Meta Audiences
- Analyze Meta Wasted Spend
- Browse Meta Targeting
- Detect Meta Creative Fatigue
- Discover Meta Assets
- Duplicate Meta Campaign
- Explain Meta Anomaly
- Get Meta Ad Creatives
- Get Meta Audience Insights
- Get Meta Campaign Details
- Get Meta Campaign Performance
- Get Meta Lead Form Submissions
- List Meta Ad Sets
- List Meta Ads
- List Meta Campaigns
- List Meta Custom Audiences
- List Meta Instagram Accounts
- List Meta Lead Forms
- List Meta Pixels
- Optimize Meta Budget
- Optimize Meta Placements
- Pause Meta Campaign
- Resume Meta Campaign
- Select Meta Campaign Type
- Update Meta Ad
- Update Meta Campaign
- Add Linkedin Creative
- Add Linkedin Text Creative
- Add Linkedin Video Creative
- Analyze Linkedin Creative Performance
- Analyze Linkedin Wasted Spend
- Associate Linkedin Conversion
- Delete Linkedin Creative
- Discover Linkedin Assets
- Explain Linkedin Anomaly
- Explain Linkedin Objectives
- Generate Linkedin Ad Creatives
- Get Linkedin Campaign Performance
- Get Linkedin Campaign Structure
- Get Linkedin Campaign Targeting
- Get Linkedin Engagement Metrics
- Get Linkedin Organizations
- List Linkedin Campaign Groups
- List Linkedin Campaigns
- List Linkedin Conversions
- List Linkedin Creatives
- Manage Linkedin Conversions
- Optimize Linkedin Budget
- Pause Linkedin Campaign
- Pause Linkedin Creative
- Resume Linkedin Campaign
- Resume Linkedin Creative
- Search Linkedin Targeting
- Select Linkedin Campaign Type
- Update Linkedin Campaign Budget
- Update Linkedin Campaign Group
- Update Linkedin Campaign Schedule
- Update Linkedin Creative
- Analyze Tiktok Geo Performance
- Analyze Tiktok Wasted Spend
- Detect Tiktok Creative Fatigue
- Discover Tiktok Assets
- Explain Tiktok Anomaly
- Get Tiktok Ad Performance
- Get Tiktok Audience Insights
- Get Tiktok Campaign Details
- Get Tiktok Campaign Performance
- List Tiktok Ad Groups
- List Tiktok Ads
- List Tiktok Campaigns
- Optimize Tiktok Budget
- Pause Tiktok Ad
- Pause Tiktok Ad Group
- Pause Tiktok Campaign
- Resume Tiktok Ad
- Resume Tiktok Ad Group
- Resume Tiktok Campaign
- Update Tiktok Campaign
- Audit Conversion Tracking
- Delete Monitor
- Get Connections Status
- Get Monitor History
- Get Research Status
- List Connected Accounts
- List Monitors
- List Pending Actions
- List Scheduled Tasks
- Manage Action
- Manage Scheduled Task
- Test Monitor
Analyze Search Terms
AI-generatedSummary
Analyze search terms data for Google Ads campaigns to identify opportunities, negatives, match types, or to retrieve raw reports, filtered by various parameters like campaign, date range, and metrics thresholds.
Inputs
- platform (required) — Select the advertising platform to analyze; for this operation, Google Ads is supported.
- analysis_type — Specify the type of analysis: 'opportunities', 'negatives', 'match_types', 'all', or 'raw_report'.
- campaign_id — Optional campaign ID to filter search term analysis to a specific campaign.
- customer_id — Google Ads customer ID to specify the account for analysis.
- date_range — Preset date ranges such as 'last_7_days', 'last_14_days', etc., to limit data.
- start_date — Start date for custom date range filter in YYYY-MM-DD format.
- end_date — End date for custom date range filter in YYYY-MM-DD format.
- lookback_days — Numeric number of days to analyze search term data (7, 30, 60, 90, or 120).
- min_clicks — Minimum number of clicks filter applied when requesting raw reports.
- page — Page number for raw report pagination (1-based).
- page_size — Number of results per page for raw reports (1-100).
- raw_data — If true, return ONLY raw metrics as a JSON code block (metrics like spend, clicks, impressions, conversions, CPA, CPC, CTR, CVR, ROAS).
- sort_by — Field used to sort raw report results; options include 'cost' (default), 'clicks', 'impressions', and 'conversions'.
- force_refresh — Boolean flag to trigger immediate API collection from Google Ads instead of cached data; currently not implemented.
Output shape
a JSON object containing analyzed search terms data, which varies by analysis_type: opportunities, negatives, match types, a full raw report with pagination and sorting, or raw metrics as a JSON code block.
Output depends on 'analysis_type' parameter. 'raw_report' supports paging and sorting; raw_data option returns only raw metrics. Other analysis types return structured summaries of opportunities or negatives. Force refresh flag is present but not yet functional; data is sourced from cached results.