KeywordToolService (AdWords API Developer's Guide)

KeywordToolService

KeywordToolService provides operations for getting new keywords based on seed keywords you provide or on the words found on a web site from a URL that you provide.

For more information about how to use the KeywordToolService, see the overview section.

The version 10 WSDL for this service is at https://adwords.google.com/api/adwords/v10/KeywordToolService?wsdl.

The version 11 WSDL for this service is at https://adwords.google.com/api/adwords/v11/KeywordToolService?wsdl.

The version 12 WSDL for this service is at https://adwords.google.com/api/adwords/v12/KeywordToolService?wsdl.

Requests

getKeywordsFromSite
getKeywordVariations

getKeywordsFromSite

Given a URL, returns keywords based on words found on that web page or site, which can be used as keyword criteria for a campaign. The results are grouped by common keywords, with the groups ordered by decreasing relevance.

Parameters

Parameter name	Parameter type	Parameter description
url	`string`	the site's location
includeLinkedPages	`boolean`	whether to follow links on the page at the given url.
languages	`string[]`	the intended target languages of the adgroup that will use the generated keywords. Must be valid targeting language codes.
countries	`string[]`	the intended target countries of the adgroup that will use the generated keywords. Must be valid targeting country codes.

Response

Response type	Response description
`SiteKeywordGroups`	the keywords related to the given site. See `SiteKeywordGroups`

getKeywordVariations

Given a list of SeedKeywords, returns their variations in multiple lists within KeywordVariations. Each list represents a different kind of variation.

Parameters

Parameter name	Parameter type	Parameter description
seedKeywords	`SeedKeyword[]`	the keywords to derive variations from. Maximum of 10.
useSynonyms	`boolean`	If true, will use synonyms of source keywords as sources
languages	`string[]`	locale information for finding variations and popularity data. Must be valid targeting language codes.
countries	`string[]`	locale information for finding variations and popularity data. Must be valid targeting country codes.

Response

Response type	Response description
`KeywordVariations`	lists of keyword variations. See `KeywordVariations`.