Keyword expansion

gads_score_keywords

Verify a specific keyword list against Google Keyword Planner BEFORE proposing it: real average monthly searches (demand 0-100) and paid-auction difficulty 0-100 (Google's competit

Verify a specific keyword list against Google Keyword Planner BEFORE proposing it: real average monthly searches (demand 0-100) and paid-auction difficulty 0-100 (Google's competition index + the top-of-page bid range), scoped to the account's own geo targets, with your current Quality Score reported per term. Difficulty is PAID difficulty, not SEO — Google exposes no organic-rank data on this surface, so 'where do we rank organically' is unavailable, never zero. Terms Google has no data for come back verified:false / band 'unverified' — treat those as long-shot broad probes, never as exact batches. The main use: run gads_ideate_keyword_silos output through this before gads_propose_add_keywords / gads_propose_create_ad_group. Also works on operator-pasted lists. ~3-6s per call.

Type: read-only. Never changes the account.

Parameters

ParameterTypeRequiredDescription
keywordsstring[]YesKeywords to verify (exact queries, not themes).
projectIdstringNoTarget account (project id). Optional when exactly one authorized stored account exists. Use gads_list_ad_accounts or gads_get_connection_status to select among multiple accounts.

On this page