Google Ads API
Keyword Planning is a process for getting keyword metrics and forecasts as well as searching for new keywords to add to campaigns. [1]
Google Keyword Planner, accessed through the Google Ads API, generates keyword ideas, historical metrics, and forecasts for campaign planning. It is a gRPC API using OAuth2, with eight official client libraries and an MCP server, and is self-serve for developers with a Google Ads account. The API is GDPR and ISO 27001 compliant. Best for teams already building on Google Ads that need programmatic keyword data.
Scores
Pricing & procurement
- Pricing model
- – Unknown [2]
- Published pricing
- ✓ Yes [3]
- Free tier
- ✓ Yes [4]
- Free tier details
- The Google Ads API is free to use; there are no charges for using the Google Ads API at Explorer Access, Basic Access, or Standard Access levels. [5]
- Self-serve signup
- ✓ Yes [6]
- Requires sales call
- ✗ No [7]
- Enterprise plan
- ✗ No [8]
Capabilities
- Supported actions
- KeywordPlanIdeaService.GenerateKeywordIdeas, KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics, KeywordPlanIdeaService.GenerateKeywordForecastMetrics, KeywordPlanIdeaService.GenerateAdGroupTheme, KeywordPlanService.mutate (create/update/remove keyword plans), KeywordPlanCampaignService.mutate (create/update/remove plan campaigns), KeywordPlanAdGroupService.mutate (create/update/remove plan ad groups), KeywordPlanAdGroupKeywordService.mutate (create/update/remove plan ad group keywords), KeywordPlanCampaignKeywordService.mutate (create/update/remove plan campaign negative keywords) [9]
- Input types
- JSON, Protobuf [10]
- Output types
- JSON, Protobuf [11]
- Webhooks
- ✗ No [12]
- Sandbox / test mode
- ✓ Yes [13]
- SDK languages
- Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go [14]
- MCP server
- ✓ Yes [15]
Trust & compliance
- SOC 2
- – Unknown [16]
- HIPAA
- – Unknown [17]
- GDPR
- ✓ Yes [18]
- ISO 27001
- ✓ Yes [19]
- PCI DSS
- ✗ No [20]
- Published SLA
- ✗ No [21]
- Rate limits
- KeywordPlanIdeaService: GenerateKeywordIdeas 1 QPS per CID, GenerateKeywordHistoricalMetrics 1 QPS per CID, GenerateKeywordForecastMetrics 1 QPS per CID, GenerateAdGroupTheme 2 QPS per CID (1 QPS calculated as 60 requests per 60 seconds). Daily API operations: Explorer Access 2,880/day against production accounts, 15,000/day against test accounts; Basic Access 15,000/day against both test and production accounts. Keyword Plan object limits: 10,000 KeywordPlan per account, 200 KeywordPlanAdGroup per KeywordPlan, 10,000 KeywordPlanAdGroupKeyword per KeywordPlan, 1,000 KeywordPlanCampaignKeyword per KeywordPlan, 1 KeywordPlanCampaign per KeywordPlan. [22]
- Known restrictions
- All requests to Keyword Planning services for both standard and basic access are rate limited. Fewer requests are allowed per minute when compared to other services., Our recommendation is to cache or store results, as you do receive the same response over a long time span., In the case of historical metrics, the statistics refresh monthly., Forecasts are based on your campaign running unmodified for the duration of the forecast period. Changing the campaign, including bids and targeting prior to the forecast period, changes performance., Google may require that your app provide certain capabilities or features as listed in the Required Minimum Functionality (RMF). Non-compliance may result in fees., KeywordPlanCampaign is limited to 1 per KeywordPlan. [23]
Developer surface
Integration
- API style
- grpc
- Base URL
- https://googleads.googleapis.com/v24
- Version
- v24
- Versioning
- url
- Stability
- ga
- Auth methods
- oauth2
- Idempotency keys
- ✗ No
- Error format
- vendor-specific
- Rate limit
- 1 / second
Adoption & maturity
- GA
- 2026-04-22
Other SEO & Keyword Data APIs
DataForSEO
We provide comprehensive SEO and digital marketing data solutions via API
Ahrefs API
With Ahrefs API, you can use data from your Ahrefs workspace to create custom integrations and automations.
Serpstat API
The most cost-effective API SEO data provider
Semrush API
Semrush API (Application Programming Interface) is a method of extracting raw Semrush data without manually logging into the platform.
Keywords Everywhere
Pull search volume, CPC, competition, related keywords, traffic and backlink data into your own app, over one REST API, using the same API key you already use in the extension.
Moz API
Moz API gives you the power to quickly create custom SEO tools, dashboards, and integrations — affordably and at scale.
References
- ↑Description: developers.google.com
- ↑Pricing model: developers.google.com
- ↑Published pricing: developers.google.com
- ↑Free tier: developers.google.com
- ↑Free tier details: developers.google.com
- ↑Self-serve signup: developers.google.com · developers.google.com
- ↑Requires sales call: developers.google.com · developers.google.com
- ↑Enterprise plan: developers.google.com
- ↑Supported actions: developers.google.com · developers.google.com · developers.google.com · developers.google.com
- ↑Input types: developers.google.com · developers.google.com
- ↑Output types: developers.google.com · developers.google.com
- ↑Webhooks: groups.google.com · zapier.com
- ↑Sandbox: developers.google.com · developers.google.com
- ↑SDK languages: developers.google.com
- ↑MCP server: developers.google.com · github.com
- ↑SOC 2: support.google.com · cloud.google.com
- ↑HIPAA: developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · business.safety.google · support.google.com · developers.google.com · developers.google.com · support.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · business.safety.google · developers.google.com
- ↑GDPR: business.safety.google · support.google.com
- ↑ISO 27001: support.google.com
- ↑PCI DSS: developers.google.com · developers.google.com · developers.google.com · developers.google.com · business.safety.google · developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · developers.google.com · business.safety.google · support.google.com · developers.google.com · developers.google.com · support.google.com
- ↑Published SLA: groups.google.com
- ↑Rate limits: developers.google.com · developers.google.com
- ↑Known restrictions: developers.google.com · developers.google.com · developers.google.com
Change history
- 2026-06-08 Docs URL: (none) → https://developers.google.com/docs
- 2026-06-08 Rendering: (none) → static
- 2026-06-08 Llms Txt Present: (none) → No
- 2026-06-07 SDK Packages: Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go → Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go
- 2026-06-07 SDK Packages: Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go → Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go
- 2026-06-07 Summary Md: (none) → Google Keyword Planner, accessed through the Google Ads API, generates keyword …
- 2026-06-07 SDK Packages: Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go → Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go
- 2026-06-07 Github Stars At: (none) → 2026-06-07T18:55:30.898Z
- 2026-06-07 Github Stars: (none) → 207
- 2026-06-07 SDK Packages: Java, C#, PHP, Python, Ruby, Perl → Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go
- 2026-06-07 MCP URL: (none) → https://github.com/googleads/google-ads-mcp
- 2026-06-07 Quickstart URL: (none) → https://developers.google.com/google-ads/api/docs/get-started/make-first-call
- 2026-06-07 Idempotency Supported: (none) → No
- 2026-06-07 Error Format: (none) → vendor-specific
- 2026-06-07 Rate Limit Window: (none) → second
- 2026-06-07 Requires Verification: (none) → No
- 2026-06-07 Data Retention Policy URL: (none) → https://support.google.com/google-ads/answer/15188209?hl=en
- 2026-06-07 GA Date: (none) → 2026-04-22
- 2026-06-07 Fields Not Found: (none) → launched_at
- 2026-06-07 SDK Languages: Java, C#, PHP, Python, Ruby, Perl → Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go
- 2026-06-07 Rate Limit Requests: (none) → 1
- 2026-06-07 Auth Methods: (none) → oauth2
- 2026-06-07 Auth Docs URL: (none) → https://developers.google.com/google-ads/api/docs/oauth/overview
- 2026-06-07 API Style: (none) → grpc
- 2026-06-07 Base URL: (none) → https://googleads.googleapis.com/v24
- 2026-06-07 API Version: (none) → v24
- 2026-06-07 Versioning Scheme: (none) → url
- 2026-06-07 Stability: (none) → ga
- 2026-06-07 Deprecation Policy URL: (none) → https://developers.google.com/google-ads/api/docs/sunset-dates
- 2026-06-07 SDK Packages: (none) → Java, C#, PHP, Python, Ruby, Perl
- 2026-06-07 Capabilities: {"local_data":true,"ppc_ad_data":true,"historical_data":true} → {"local_data":true,"ppc_ad_data":true,"historical_data":true}