Google Ads API

Best for: Prototypes and side projects - free to start, no sales call; AI agents and automation - an agent-ready surface (MCP / llms.txt); Teams needing broad API coverage out of the box

Avoid if: You have strict compliance requirements

Pricing model

– Unknown [2]developers.google.com/google-ads/api/docs/productionize/access-levels“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.”

Published pricing

✓ Yes [3]developers.google.com/google-ads/api/docs/productionize/access-levels“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.”

Free tier

✓ Yes [4]developers.google.com/google-ads/api/docs/productionize/access-levels“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.”

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]developers.google.com/google-ads/api/docs/productionize/access-levels“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.”

Self-serve signup

✓ Yes [6]developers.google.com/google-ads/api/docs/get-started/make-first-call“How to sign up for a developer token · Navigate to API Center in your web browser. Sign in to your Google Ads manager account if prompted. · Complete the API”developers.google.com/google-ads/api/docs/best-practices/test-accounts“Don't require an approved developer token, so you can start experimenting with the API immediately, even before your application is reviewed or approved.”

Requires sales call

✗ No [7]developers.google.com/google-ads/api/docs/get-started/make-first-call“How to sign up for a developer token · Navigate to API Center in your web browser. Sign in to your Google Ads manager account if prompted. · Complete the API”developers.google.com/google-ads/api/docs/best-practices/test-accounts“Don't require an approved developer token, so you can start experimenting with the API immediately, even before your application is reviewed or approved.”

Enterprise plan

✗ No [8]developers.google.com/google-ads/api/docs/productionize/access-levels“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.”

• Historical data
• Local / geo data
• PPC / ad data

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]developers.google.com/google-ads/api/docs/keyword-planning/overview“Keyword Planning is a process for getting keyword metrics and forecasts as well as searching for new keywords to add to campaigns.”developers.google.com/google-ads/api/docs/keyword-planning/generate-historical-metrics“To generate historical metrics call KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics with the parameters you would like to include.”developers.google.com/google-ads/api/docs/keyword-planning/generate-keyword-ideas“Using the KeywordPlanIdeaService , you can search for new keywords that are relevant to your Google Search campaign, or find historical metrics on keywords”developers.google.com/google-ads/api/docs/keyword-planning/generate-forecast-metrics“Forecast metrics provide metrics for proposed or existing campaigns, including: Impressions; Click through rate; Average cost per click; Clicks; Cost.”

Input types

JSON, Protobuf [10]developers.google.com/google-ads/api/rest/design/json-mappings“When using the Google Ads API's REST interface, you're working with JSON representations of the same resources and types defined in the Google Ads API's .proto”developers.google.com/google-ads/api/docs/client-libs/dotnet/working-with-protobuf“The Google Ads API uses proto3 as its default payload format, requiring an understanding of its conventions and types.”

Output types

JSON, Protobuf [11]developers.google.com/google-ads/api/rest/design/json-mappings“When using the Google Ads API's REST interface, you're working with JSON representations of the same resources and types defined in the Google Ads API's .proto”developers.google.com/google-ads/api/docs/client-libs/dotnet/working-with-protobuf“The Google Ads API uses proto3 as its default payload format, requiring an understanding of its conventions and types.”

Webhooks

✗ No [12]groups.google.com/g/adwords-api/c/PKwAU1ZI1HQ“I'd like to be able to set a balance threshold, and receive a notification (e.g., via email or webhook) when the account balance drops below”zapier.com/apps/google-ads/integrations/webhook“When offline sales data is updated via a webhook, Zapier can push the information to Google Ads as offline conversions.”

Sandbox / test mode

✓ Yes [13]developers.google.com/merchant/api/guides/accounts/test-accounts“By using sandboxed test accounts, you can experiment with API calls, validate code, and identify potential issues early in the development cycle”developers.google.com/google-ads/api/docs/best-practices/test-accounts“Don't require an approved developer token, so you can start experimenting with the API immediately, even before your application is reviewed or approved. Can't”

SDK languages

Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go [14]developers.google.com/google-ads/api/docs/client-libs“Our client libraries provide high-level views and basic building blocks of Google Ads API functionality, making it easier to develop apps quickly.”

MCP server

✓ Yes [15]developers.google.com/google-ads/api/docs/developer-toolkit/mcp-server“The Model Context Protocol (MCP) is an open standard that enables Large Language Models (LLMs) to securely interact with external data and”github.com/google-marketing-solutions/google_ads_mcp“The Google Ads MCP Server is an implementation of the Model Context Protocol (MCP) that enables Large Language Models (LLMs), such as Gemini, to interact”

SOC 2

– Unknown [16]support.google.com/google-ads/thread/102096619/security-compliance-reports“I am looking to identify the security compliance reports eg ISO27001 or SOC2 reports for Google Marketing Platform products.”cloud.google.com/security/compliance/soc-2“Google Cloud undergoes a regular third-party audit to certify individual products against SOC 2 standards.”

HIPAA

– Unknown [17]developers.google.com/google-ads/api/docs/best-practices/quotasdevelopers.google.com/google-ads/api/docs/keyword-planning/overviewdevelopers.google.com/google-ads/api/docs/keyword-planning/generate-keyword-ideasdevelopers.google.com/google-ads/api/docs/client-libsdevelopers.google.com/google-ads/api/docs/api-policy/developer-tokenbusiness.safety.google/compliance/support.google.com/google-ads/answer/9433788developers.google.com/google-ads/api/docs/targeting/location-targetingdevelopers.google.com/google-ads/api/support/compliancesupport.google.com/google-ads/answer/7459813developers.google.com/google-ads/api/docs/productionize/rate-limitsdevelopers.google.com/google-ads/api/docs/keyword-planning/generate-forecast-metricsdevelopers.google.com/google-ads/api/docs/keyword-planning/generate-historical-metricsdevelopers.google.com/google-ads/api/docs/api-policy/rate-sheetdevelopers.google.com/google-ads/api/docs/best-practices/test-accountsdevelopers.google.com/google-ads/api/docs/developer-toolkit/mcp-serverdevelopers.google.com/google-ads/api/docs/api-policy/termsdevelopers.google.com/google-ads/api/docs/productionize/access-levelsbusiness.safety.google/compliance/developers.google.com/google-ads/api/rest/design/json-mappings

GDPR

✓ Yes [18]business.safety.google/compliance/“GDPR. The General Data Protection Regulation (GDPR) went into effect May 25, 2018.”support.google.com/analytics/answer/3379636“The Google Ads Data Processing Terms are meant for businesses affected by the European Economic Area (EEA) General Data Protection Regulation (GDPR),”

ISO 27001

✓ Yes [19]support.google.com/google-ads/answer/9433788“Google has earned ISO 27001 certification for the systems, applications, people, technology, processes and data centers serving a number of Google products.”

PCI DSS

✗ No [20]developers.google.com/google-ads/api/docs/best-practices/test-accountsdevelopers.google.com/google-ads/api/docs/developer-toolkit/mcp-serverdevelopers.google.com/google-ads/api/docs/api-policy/termsdevelopers.google.com/google-ads/api/docs/productionize/access-levelsbusiness.safety.google/compliance/developers.google.com/google-ads/api/rest/design/json-mappingsdevelopers.google.com/google-ads/api/docs/productionize/rate-limitsdevelopers.google.com/google-ads/api/docs/keyword-planning/generate-forecast-metricsdevelopers.google.com/google-ads/api/docs/keyword-planning/generate-historical-metricsdevelopers.google.com/google-ads/api/docs/api-policy/rate-sheetdevelopers.google.com/google-ads/api/docs/best-practices/quotasdevelopers.google.com/google-ads/api/docs/keyword-planning/overviewdevelopers.google.com/google-ads/api/docs/keyword-planning/generate-keyword-ideasdevelopers.google.com/google-ads/api/docs/client-libsdevelopers.google.com/google-ads/api/docs/api-policy/developer-tokenbusiness.safety.google/compliance/support.google.com/google-ads/answer/9433788developers.google.com/google-ads/api/docs/targeting/location-targetingdevelopers.google.com/google-ads/api/support/compliancesupport.google.com/google-ads/answer/7459813

Published SLA

✗ No [21]groups.google.com/g/adwords-api/c/82FOMMMA9DM“Hi Team, I would like to know how frequently the cost_micros, campaign_budget_name, ads_spent_date_ct, clicks , impressions etc gets updated”

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]developers.google.com/google-ads/api/docs/best-practices/quotas“1 QPS is calculated as 60 requests per 60 seconds. Limited to 2 requests per second per CID: KeywordPlanIdeaService.GenerateAdGroupTheme.”developers.google.com/google-ads/api/docs/productionize/rate-limits“The Google Ads API buckets requests for rate limiting by queries per second (QPS) per client customer ID (CID) and developer token.”

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]developers.google.com/google-ads/api/docs/productionize/access-levelsdevelopers.google.com/google-ads/api/docs/keyword-planning/overviewdevelopers.google.com/google-ads/api/docs/best-practices/quotas

• Docs
• API reference

Docs rendering: static

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

SDKs

• Java com.google.api-ads:google-ads · repo · updated 2026-06 · 207★
• Python google-ads · repo · updated 2026-06 · 707★
• .NET Google.Ads.GoogleAds · repo · updated 2026-06 · 87★
• PHP googleads/google-ads-php · repo · updated 2026-06 · 347★
• Ruby google-ads-googleads · repo · updated 2026-05 · 83★
• Perl Google::Ads::GoogleAds · repo · updated 2026-05 · 20★
• Node.js google-ads-api · repo
• Go github.com/shenzhencenter/google-ads-pb · repo · updated 2026-05 · 109★

• Auth docs
• Quickstart
• MCP server
• Deprecation policy

GA

2026-04-22

• DataForSEO

  We provide comprehensive SEO and digital marketing data solutions via API

  Usage · public pricing · self-serve

• Ahrefs API

  With Ahrefs API, you can use data from your Ahrefs workspace to create custom integrations and automations.

  Hybrid · public pricing · self-serve

• Serpstat API

  The most cost-effective API SEO data provider

  Subscription · public pricing · self-serve

• Semrush API

  Semrush API (Application Programming Interface) is a method of extracting raw Semrush data without manually logging into the platform.

  Hybrid · public pricing · self-serve

• 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.

  Hybrid · free tier · public pricing · self-serve

• Moz API

  Moz API gives you the power to quickly create custom SEO tools, dashboards, and integrations - affordably and at scale.

  Hybrid · free tier · public pricing · self-serve

Google Ads API alternatives · Google Ads API vs DataForSEO · All SEO & Keyword Data APIs APIs

Each field above carries a numbered source - hover for a preview, click to jump here.

1. ↑Description: developers.google.com
2. ↑Pricing model: developers.google.com
3. ↑Published pricing: developers.google.com
4. ↑Free tier: developers.google.com
5. ↑Free tier details: developers.google.com
6. ↑Self-serve signup: developers.google.com · developers.google.com
7. ↑Requires sales call: developers.google.com · developers.google.com
8. ↑Enterprise plan: developers.google.com
9. ↑Supported actions: developers.google.com · developers.google.com · developers.google.com · developers.google.com
10. ↑Input types: developers.google.com · developers.google.com
11. ↑Output types: developers.google.com · developers.google.com
12. ↑Webhooks: groups.google.com · zapier.com
13. ↑Sandbox: developers.google.com · developers.google.com
14. ↑SDK languages: developers.google.com
15. ↑MCP server: developers.google.com · github.com
16. ↑SOC 2: support.google.com · cloud.google.com
17. ↑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
18. ↑GDPR: business.safety.google · support.google.com
19. ↑ISO 27001: support.google.com
20. ↑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
21. ↑Published SLA: groups.google.com
22. ↑Rate limits: developers.google.com · developers.google.com
23. ↑Known restrictions: developers.google.com · developers.google.com · developers.google.com

Every field change, who made it, and when - from our audited data pipeline and editors.

1. 2026-06-15 Score Agent Friendliness: 40 → 60
2. 2026-06-15 Score Docs Quality: 15 → 35
3. 2026-06-15 API Reference URL: (none) → https://developers.google.com/workspace/docs/api/how-tos/overview
4. 2026-06-15 Robots Allows Agents: (none) → Yes
5. 2026-06-15 Has Structured Data: (none) → Yes
6. 2026-06-09 Best For: Prototypes and side projects — free to start, no sales call, AI agents and auto… → Prototypes and side projects - free to start, no sales call, AI agents and auto…
7. 2026-06-09 Scoring Methodology: Scores are computed deterministically from this profile's published, sourced fi… → Scores are computed deterministically from this profile's published, sourced fi…
8. 2026-06-09 Score Procurement Friction: (none) → 90
9. 2026-06-09 Avoid If: (none) → You have strict compliance requirements
10. 2026-06-09 Best For: (none) → Prototypes and side projects — free to start, no sales call, AI agents and auto…
11. 2026-06-09 Scoring Methodology: (none) → Scores are computed deterministically from this profile's published, sourced fi…
12. 2026-06-09 Score Docs Quality: (none) → 15
13. 2026-06-09 Score Setup Speed: (none) → 100
14. 2026-06-09 Score Pricing Transparency: (none) → 75
15. 2026-06-09 Score Agent Friendliness: (none) → 40
16. 2026-06-09 Score Trust Readiness: (none) → 30
17. 2026-06-08 Rendering: (none) → static
18. 2026-06-08 Docs URL: (none) → https://developers.google.com/docs
19. 2026-06-08 Llms Txt Present: (none) → No
20. 2026-06-07 SDK Packages: Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go → Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go
21. 2026-06-07 SDK Packages: Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go → Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go
22. 2026-06-07 Summary Md: (none) → Google Keyword Planner, accessed through the Google Ads API, generates keyword …
23. 2026-06-07 SDK Packages: Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go → Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go
24. 2026-06-07 Github Stars At: (none) → 2026-06-07T18:55:30.898Z
25. 2026-06-07 Github Stars: (none) → 207
26. 2026-06-07 Auth Methods: (none) → oauth2
27. 2026-06-07 SDK Languages: Java, C#, PHP, Python, Ruby, Perl → Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go
28. 2026-06-07 Fields Not Found: (none) → launched_at
29. 2026-06-07 GA Date: (none) → 2026-04-22
30. 2026-06-07 Data Retention Policy URL: (none) → https://support.google.com/google-ads/answer/15188209?hl=en
31. 2026-06-07 Requires Verification: (none) → No
32. 2026-06-07 Rate Limit Window: (none) → second
33. 2026-06-07 Rate Limit Requests: (none) → 1
34. 2026-06-07 Error Format: (none) → vendor-specific
35. 2026-06-07 Idempotency Supported: (none) → No
36. 2026-06-07 Quickstart URL: (none) → https://developers.google.com/google-ads/api/docs/get-started/make-first-call
37. 2026-06-07 MCP URL: (none) → https://github.com/googleads/google-ads-mcp
38. 2026-06-07 SDK Packages: Java, C#, PHP, Python, Ruby, Perl → Java, Python, .NET, PHP, Ruby, Perl, Node.js, Go
39. 2026-06-07 Deprecation Policy URL: (none) → https://developers.google.com/google-ads/api/docs/sunset-dates
40. 2026-06-07 Stability: (none) → ga
41. 2026-06-07 Versioning Scheme: (none) → url
42. 2026-06-07 API Version: (none) → v24
43. 2026-06-07 Base URL: (none) → https://googleads.googleapis.com/v24
44. 2026-06-07 API Style: (none) → grpc
45. 2026-06-07 Auth Docs URL: (none) → https://developers.google.com/google-ads/api/docs/oauth/overview
46. 2026-06-07 SDK Packages: (none) → Java, C#, PHP, Python, Ruby, Perl
47. 2026-06-07 Capabilities: {"local_data":true,"ppc_ad_data":true,"historical_data":true} → {"local_data":true,"ppc_ad_data":true,"historical_data":true}

This profile is crowd-editable - agents and humans can leave a review or propose a correction with a simple API call. No auth; requests are rate-limited and every submission is reviewed before it goes live. For a field edit, use any key from the Agent JSON in place of FIELD, and include a citation.

curl -X POST https://apio.sh/api/feedback/google-keyword-planner \
  -H 'Content-Type: application/json' \
  -d '{"kind":"review","rating":5,"body":"Your experience with this API…"}'

curl -X POST https://apio.sh/api/suggest/google-keyword-planner/FIELD \
  -H 'Content-Type: application/json' \
  -d '{"value":"corrected value","citations":[{"url":"https://source.example/page","excerpt":"supporting quote"}],"note":"what changed and why"}'

All the ways to contribute →