How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Google Ads

Google Ads V25 API

The v25 API from Google Ads — 9 operation(s) for v25.

Documentation Provider Profile APIs.io OpenAPI GitHub

Google Ads V25 API is one of 109 APIs that Google Ads publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include v25. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a getting-started guide, and rate-limit docs.

This API exposes 9 operations across 9 paths, and defines 41 schemas. It is described by OpenAPI 3.2.0, at version v25.

Requests are made against a single base URL, https://googleads.googleapis.com.

9 operations 9 paths 41 schemas 9 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v25
Base URL
https://googleads.googleapis.com
Authentication
OAuth 2.0
Contact
Google
Terms of Service
View terms
Resource Areas
1

Authentication & Security 1

Google Ads V25 API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow, exposing 1 scope. By default, every request must be authenticated.

  • oauth2 — Google OAuth 2.0. Google Ads API additionally requires a developer token in the developer-token header.

Paths & Operations 9

Across 9 paths, the API surfaces 9 operations — 9 POST. Each is listed below with its method, path, parameters, and response codes.

v25 9
POST
/v25:listBenchmarksLocations
Returns the list of locations that support benchmarks (for example, countries)
googleads_listBenchmarksLocations 11 params body → 200
POST
/v25:listPlannableProducts
Returns the list of per-location plannable YouTube ad formats with allowed targeting
googleads_listPlannableProducts 11 params body → 200
POST
/v25:generateConversionRates
Returns a collection of conversion rate suggestions for supported plannable products
googleads_generateConversionRates 11 params body → 200
POST
/v25:listBenchmarksAvailableDates
Returns a date range that supports benchmarks
googleads_listBenchmarksAvailableDates 11 params body → 200
POST
/v25:listPlannableUserLists
Returns the list of plannable user lists with their plannable status
googleads_listPlannableUserLists 11 params body → 200
POST
/v25:listPlannableUserInterests
Returns the list of plannable user interests
googleads_listPlannableUserInterests 11 params body → 200
POST
/v25:listBenchmarksProducts
Returns the list of products that supports benchmarks
googleads_listBenchmarksProducts 11 params body → 200
POST
/v25:listPlannableLocations
Returns the list of plannable locations (for example, countries)
googleads_listPlannableLocations 11 params body → 200
POST
/v25:listBenchmarksSources
Returns the list of benchmarks sources (for example, Industry Verticals)
googleads_listBenchmarksSources 11 params body → 200

Schemas 41

The contract defines 41 schemas that model the data the API accepts and returns. The most detailed are GoogleAdsGoogleadsV25Services__PlannableTargeting (6 properties), GoogleAdsGoogleadsV25Services__ProductMetadata (5 properties), GoogleAdsGoogleadsV25Services__ListPlannableUserInterestsRequest (5 properties), GoogleAdsGoogleadsV25Services__PlannableUserList (5 properties). Each schema is shown below with its type and property counts.

GoogleAdsGoogleadsV25Services__PlannableUserListMetadata
object
The metadata associated with a plannable user list.
1 property
GoogleAdsGoogleadsV25Services__SurfaceTargeting
object
Container for surfaces for a product. Surfaces refer to the available types of ad inventories such as In-Feed, In-Stream, and Shorts.
1 property
GoogleAdsGoogleadsV25Services__ListBenchmarksAvailableDatesRequest
object
Request message for BenchmarksService.ListBenchmarksAvailableDates.
1 property
GoogleAdsGoogleadsV25Services__ListBenchmarksLocationsResponse
object
Response message for BenchmarksService.ListBenchmarksLocations.
1 property
GoogleAdsGoogleadsV25Services__ProductCoreAttributes
object
A collection of attributes that offer more information about a specific product.
3 properties
GoogleAdsGoogleadsV25Services__ListBenchmarksSourcesRequest
object
Request message for BenchmarksService.ListBenchmarksSources.
2 properties
GoogleAdsGoogleadsV25Services__ListBenchmarksProductsRequest
object
Request message for BenchmarksService.ListBenchmarksProducts.
1 property
GoogleAdsGoogleadsV25Services__SurfaceTargetingCombinations
object
The surface targeting combinations available for an ad product.
2 properties
GoogleAdsGoogleadsV25Services__ProductMetadata
object
The metadata associated with an available plannable product.
5 properties
GoogleAdsGoogleadsV25Common__AdditionalApplicationInfo
object
Additional information about the application/tool issuing the request. This field is only used by ContentCreatorInsightsService, AudienceInsightsService, and R…
2 properties
GoogleAdsGoogleadsV25Services__ListBenchmarksProductsResponse
object
Response message for BenchmarksService.ListBenchmarksProducts.
1 property
GoogleAdsGoogleadsV25Services__BenchmarksSourceMetadata
object
The metadata associated with a benchmarks source.
2 properties
GoogleAdsGoogleadsV25Services__ListBenchmarksSourcesResponse
object
Response message for BenchmarksService.ListBenchmarksSources.
1 property
GoogleAdsGoogleadsV25Services__YouTubeSelectLineUpTargeting
object
Targetable YouTube Select Lineups for the ad product and the default Lineup.
2 properties
GoogleAdsGoogleadsV25Services__BenchmarksLocation
object
A location that supports benchmarks data.
3 properties
GoogleAdsGoogleadsV25Common__LocationInfo
object
A location criterion.
1 property
GoogleAdsGoogleadsV25Services__ConversionRateSuggestion
object
A conversion rate suggestion.
4 properties
GoogleAdsGoogleadsV25Services__ListPlannableLocationsResponse
object
The list of plannable locations.
1 property
GoogleAdsGoogleadsV25Services__ListPlannableProductsRequest
object
Request to list available products in a given location.
2 properties
GoogleAdsGoogleadsV25Services__PlannableTargeting
object
The targeting for which traffic metrics will be reported.
6 properties
GoogleAdsGoogleadsV25Services__IndustryVerticalInfo
object
The information associated with an Industry Vertical.
3 properties
GoogleAdsGoogleadsV25Services__ListPlannableLocationsRequest
object
Request message for ReachPlanService.ListPlannableLocations.
1 property
GoogleAdsGoogleadsV25Services__PlannableLocation
object
A plannable location: country, metro region, province, etc.
5 properties
GoogleAdsGoogleadsV25Common__DeviceInfo
object
A device criterion.
1 property
GoogleAdsGoogleadsV25Services__ListPlannableUserListsRequest
object
Request message for ReachPlanService.ListPlannableUserLists that lists the available user lists for a customer.
3 properties
GoogleAdsGoogleadsV25Services__ListBenchmarksAvailableDatesResponse
object
Response message for BenchmarksService.ListBenchmarksAvailableDates.
1 property
GoogleAdsGoogleadsV25Services__BenchmarksProductMetadata
object
The metadata associated with a product supported for benchmarks data.
3 properties
GoogleAdsGoogleadsV25Services__GenerateConversionRatesRequest
object
Request message for ReachPlanService.GenerateConversionRates.
3 properties
GoogleAdsGoogleadsV25Services__ListBenchmarksLocationsRequest
object
Request message for BenchmarksService.ListBenchmarksLocations.
1 property
GoogleAdsGoogleadsV25Common__GenderInfo
object
A gender criterion.
1 property
GoogleAdsGoogleadsV25Services__ListPlannableUserListsResponse
object
A response with all available user lists with their plannable status.
1 property
GoogleAdsGoogleadsV25Common__UserInterestInfo
object
Represents a particular interest-based topic to be targeted.
1 property
GoogleAdsGoogleadsV25Services__GenerateConversionRatesResponse
object
Response message for ReachPlanService.GenerateConversionRates, containing conversion rate suggestions for supported plannable products.
1 property
GoogleAdsGoogleadsV25Services__ListPlannableProductsResponse
object
A response with all available products.
1 property
GoogleAdsGoogleadsV25Services__ListPlannableUserInterestsRequest
object
Request message for ReachPlanService.ListPlannableUserInterests.
5 properties
GoogleAdsGoogleadsV25Services__PlannableUserInterest
object
A plannable user interest that can be targeted in a reach forecast using ReachPlanService.GenerateReachForecast.
4 properties
GoogleAdsGoogleadsV25Services__YouTubeSelectLineUp
object
A Plannable YouTube Select Lineup for product targeting.
2 properties
GoogleAdsGoogleadsV25Services__ListPlannableUserInterestsResponse
object
Response message for ReachPlanService.ListPlannableUserInterests.
1 property
GoogleAdsGoogleadsV25Common__UserListInfo
object
A User List criterion. Represents a user list that is defined by the advertiser to be targeted.
1 property
GoogleAdsGoogleadsV25Common__DateRange
object
A date range.
2 properties
GoogleAdsGoogleadsV25Services__PlannableUserList
object
A plannable user list.
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

google-ads-v25-api-openapi.yml Raw ↑

Other APIs Google Ads publishes across the network.

Google Ads Scripts
AE Profile APIs.io
Google Ads Ad Groups API
AE Profile APIs.io
Google Ads Ads API
AE Profile APIs.io
Google Ads Bidding Strategies API
AE Profile APIs.io
Google Ads Campaigns API
AE Profile APIs.io
Google Ads Customers API
AE Profile APIs.io
Google Ads Keywords API
AE Profile APIs.io
Google Ads Reporting API
AE Profile APIs.io
Google Ads Audience Insights API
AE Profile APIs.io
Google Ads Customers.account Budget Proposals API
AE Profile APIs.io
Google Ads Customers.account Links API
AE Profile APIs.io
Google Ads Customers.ad Group Ad Labels API
AE Profile APIs.io
#v25
← Back to G APIs
API Details
ID
google-ads:google-ads-v25-api
Base URL
https://googleads.googleapis.com
Docs
https://developers.google.com/google-ads/scripts/docs/start
Provider
Google Ads
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=google-ads-v25-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/google-ads-v25-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Google Ads V25 API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.