Skip to main content
Google AdsVersion: v3

Get keyword ideas

POST/ad-publishing/google/keyword-ideas

Retrieve keyword suggestions for Google Ads campaigns

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

locationIdstringrequired

Location identifier

Example:HChooFuiyPpVYzeJ4HMe

Body

application/json
urlstringrequired

Target URL

Example:https://example.com
languageCodestring

Language code

Example:en
locationsstring[]

Target locations

Example:["US","CA"]
keywordsstring[]

Seed keywords

Example:["marketing"]

Response

application/json

Keyword suggestions ordered by search volume, highest first

  • Array items
    • textstringrequired

    Suggested keyword

    Example:crm software
    avgMonthlySearchesstringrequired

    Average monthly search volume, returned as a string rather than a number

    Example:450000