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.

When to use it

Use it when you plan keywords for a Search campaign. Seed it with up to 10 keywords, a landing page url, or both. One of the two is required.
Every call reads Google Keyword Planner live through your own Google connection. Nothing is cached.
Pass geo_target_ids from adsap_google_search_geo_targets and a language_id. The default language_id is 1000, English.
Bids come back as amounts in the account currency.
The chosen texts go into ad_group.keywords of adsap_google_create_search_campaign. For an existing ad group, use adsap_google_manage_keywords.

Worked example

You ask

“Give me French keyword ideas for trail running shoes in France, with search volume, for account 1234567890.”

The assistant calls `adsap_google_keyword_ideas`


{
  "ad_account_id": "1234567890",
  "keywords": ["chaussures de trail", "chaussures running"],
  "geo_target_ids": ["2250"],
  "language_id": "1002",
  "page_size": 50
}

Adsap returns

The field names are the ones Adsap returns. The values are examples.


{
  "ok": true,
  "data": [
    {
      "text": "chaussures de trail",
      "avg_monthly_searches": 40500,
      "competition": "HIGH",
      "competition_index": 88,
      "low_top_of_page_bid": 0.21,
      "high_top_of_page_bid": 0.74
    },
    {
      "text": "chaussures trail femme",
      "avg_monthly_searches": 12100,
      "competition": "HIGH",
      "competition_index": 95,
      "low_top_of_page_bid": 0.18,
      "high_top_of_page_bid": 0.62
    }
  ],
  "meta": {
    "total_count": 38,
    "next_page_token": null,
    "note": "Bids are in the account's currency. Pass chosen texts (with a match type) into adsap_google_create_search_campaign ad_group.keywords."
  }
}

How to read it

The example shows 2 of the 38 ideas. avg_monthly_searches is the average monthly search volume for the locations and language you passed. competition is Google’s label and competition_index is its numeric index. The two bid fields give the low and high ends of the top-of-page bid range. Any of these fields is null when Google reports no value.

2250 is the geo target ID for France and 1002 is the language ID for French. When meta.next_page_token is set, pass it as page_token to get the next page. To add ideas to a campaign, pick the texts and give each one a match type.

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.

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.

The Google Ads MCP server page shows how to connect Google Ads to Claude, ChatGPT or Perplexity.

Get Google Ads keyword ideas (adsap_google_keyword_ideas)