Google Ads Keyword Idea Details

Provide one or two seed terms and a target market to inspect one returned Google Ads keyword idea through DataForSEO. Get a single record with available search and advertising metrics, rather than a list of ideas.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Check current availability and execution cost. Ask only for missing search phrases or a country or area name in everyday words. Resolve a clear place name to a currently supported Google Ads search location internally. If the place is unclear or could mean several locations, ask the user to choose by familiar place names; never ask the user to find or enter a numeric code. Provide 1–2 short search phrases (1–80 characters each) and the required search place. The provider changes search phrases to lowercase and may reject some symbols or emojis. “[coffee beans]” and “[the United States]” are examples, not defaults. Do not add a language setting; this Tool has no language choice.

Interpret only the one first returned keyword record. Identify that keyword before explaining its available approximate average monthly searches, CPC in USD, paid-ad competition and dated monthly search values. A 0–100 competition index concerns ad placement, not SEO difficulty. CPC describes advertising clicks, not this Tool’s fee or a recommended bid. Read actual returned years and months; history may lag or omit periods. Preserve zero, null and missing information separately. Help the user assess topic fit without promising a new, best or different keyword, a record for each seed, or a complete list. Do not infer an omitted language default, current traffic or future performance.

Task:
Find one search phrase used for ads related to [coffee beans] in [the United States]. Show roughly how often people search for it each month and what one ad click may cost.

Paste into your connected AI's conversation.

Connection guide

Up to 0.155001 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

DataForSEO

Google Ads Keyword Idea Details

You receive

Receive the first keyword record returned for your seed terms and market. Available details can include the keyword, approximate average monthly searches, cost per click (CPC) in USD, paid-ad competition and its 0–100 index, and dated monthly search values. Your Agent can explain the available metrics and help assess how the returned keyword relates to your topic. The keyword may be the same as a seed term.

Start with your task

Find one search phrase used for ads related to [coffee beans] in [the United States]. Show roughly how often people search for it each month and what one ad click may cost.

What to know

This Tool delivers one record, without a complete suggestion list or a separate record for each seed. It does not guarantee a new or best keyword. Monthly data can lag or omit periods. Search volume is not clicks, people or a traffic forecast; paid competition is not organic keyword difficulty.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Keyword idea request`request`	`object`	Required	Required object containing the seed-term array and supported location code. Provide both for the current query. Required fields `location_code, keywords`
Seed terms`request.keywords`	`array`	Required	Required array of 1–2 seed terms. These terms guide the keyword lookup; two seeds do not create a separate output record for each. Minimum items `1` Maximum items `2`
Each seed term`request.keywords[]`	`string`	—	Each array item is a string of 1–256 characters under the Tool’s validation. For provider compatibility, use 1–80 characters. Seeds are converted to lowercase, and some symbols or characters, including emojis, are not accepted by Google Ads. Minimum length `1` Maximum length `256`
Target-market code`request.location_code`	`integer`	Required	Required supported Google Ads location code, supplied as an integer within 1–100000000. US code 2840 is illustrative, not a default. A number within the range is not necessarily a supported location. Language and date choices are not inputs to this Tool. Minimum `1` Maximum `100000000`

View raw JSON

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "location_code",
        "keywords"
      ],
      "properties": {
        "keywords": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 256,
            "minLength": 1
          },
          "maxItems": 2,
          "minItems": 1
        },
        "location_code": {
          "type": "integer",
          "maximum": 100000000,
          "minimum": 1
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

For metric definitions, see DataForSEO’s Google Ads keyword-idea reference. Keep the reported year and month beside each historical value when your Agent formats the data.

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

The Tool provides one first returned keyword record, even when you supply two seeds. It may repeat a seed and is not guaranteed to be the best or a new term. Check the actual returned keyword before interpreting its metrics; there is no complete suggestion list or separate per-seed table.

Google Ads Keyword Idea Details

Google Ads Keyword Idea Details

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Choose a topic

Choose where to look

Understand the result

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Choose a topic

Choose where to look

Understand the result

Questions about this tool.

Will I get a new keyword for each seed?

Is the competition index an SEO difficulty score?

Does CPC tell me what this Tool costs or what I should bid?

How should I read search volume and monthly history?

Why might a seed produce no data?