Get Google Ads keyword ideas (adsap_google_keyword_ideas)
Platform: Google Ads · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No
What it does
Pulls keyword suggestions from Google Keyword Planner using seed keywords, a landing page URL, or both. Each idea comes with average monthly searches, competition and a top-of-page bid range in the account currency. Scope the volumes by location and language so they match your campaign.
Parameters
Descriptions are shortened from the tool schema. Your assistant sees the full text.
| Name | Type | Required | Description |
|---|---|---|---|
ad_account_id | string | Yes | Bare 10-digit Google Ads customer ID (from adsap_google_list_ad_accounts). No dashes, no act_ prefix. |
keywords | array of string | No | Seed keywords, e.g. [‘running shoes’, ‘trail sneakers’]. Max 10. At least one of keywords/url is required. |
url | string | No | Landing-page URL to extract ideas from (http/https). Combines with keywords when both are given. |
geo_target_ids | array of string | No | Geo target constant ids to scope volumes (from adsap_google_search_geo_targets). Max 10; omit for worldwide. |
language_id | string | No | Language constant id (default 1000 = English). |
page_size | number | No | |
page_token | string | No | Pagination token from a previous call’s meta.next_page_token. |
Example prompts
- “Give me keyword ideas for running shoes in the United States, with search volume.”
- “What keywords does Google suggest for my landing page https://example.com/trail-shoes ?”
- “Find French keyword ideas for ‘chaussures de trail’ targeting France.”
Notes
Up to 10 seed keywords per call. Omit locations for worldwide volumes.
Related tools
adsap_google_manage_keywords: Manage Google Ads Search keywords AFTER creation.adsap_google_manage_targeting: Manage a Google Ads campaign or ad group’s targeting AFTER creation: GEO, LANGUAGE and AUDIENCES.adsap_google_search_geo_targets: Find Google Ads geo target constants by location name (city, region, country, postal area) for Search campaign location targeting.adsap_google_search_terms: Search terms report for a Google Ads account: the REAL user queries that triggered Search (and Shopping) ads, with…
Guide
Read Keywords for the workflow around this tool, and the Tool reference for every tool.
Last updated on