bugs in KeywordIdeas

[Andrey Eblukov]

Hello, I found some bugs in KeywordIdeas API:

1. 'pageSize' parametr in KeywordIdeas

Request code example:
$response = $keywordPlanIdeaServiceClient->generateKeywordIdeas([
    'pageSize' => 1000,
    'keywordSeed' = new KeywordSeed(['keywords' => [
        "wig lace front",
        "hiker boot",
        "jacket carhartt"


When trying to set pageSize to 500 or less, an error is returned all the time: "Too many requests. Retry in 4 seconds."

If set this parameter 'pageSize' => 1000 or 'pageSize' => 5000 or 'pageSize' => 10000, - nothing changes as a result, 8871 words are returned all the time.

Please make this setting work.


2. autocorrect words that are set in KeywordIdeas

For example, I am trying to generate ideas for:
"dr.house"
"c+language"

In this case, characters are replaced (as I understand it, according to the rules https://support.google.com/google-ads/answer/7476658).

Response KeywordIdeas example:
{"text":"dr house","keywordIdeaMetrics":{"avgMonthlySearches":"22200","monthlySearchVolumes":[{"year":"2022","month":"FEBRUARY","monthlySearches":"22200"}],"competition":"LOW","competitionIndex":"1","lowTopOfPageBidMicros":"1660000","highTopOfPageBidMicros":"4570000"},"keywordAnnotations":[]},{"text":"c language","keywordIdeaMetrics":{"avgMonthlySearches":"4400","monthlySearchVolumes":[{"year":"2022","month":"FEBRUARY","monthlySearches":"5400"}],"competition":"LOW","competitionIndex":"2","lowTopOfPageBidMicros":"1047120","highTopOfPageBidMicros":"4240000"},"keywordAnnotations":[]}

set "dr.house", response "text":"dr house"
set "c+language", response "text":"c language"

In the ForecastMetrics endpoint, the "closeVariants" field has been added, which is convenient to navigate.

Response ForecastMetrics example:
{"searchQuery":"dr house","closeVariants":["dr.house"],"keywordMetrics":{"avgMonthlySearches":"22200","monthlySearchVolumes":[{"year":"2022","month":"FEBRUARY","monthlySearches":"22200"}],"competition":"LOW","competitionIndex":"1","lowTopOfPageBidMicros":"1660000","highTopOfPageBidMicros":"4570000"}},{"searchQuery":"c language","closeVariants":["c+language"],"keywordMetrics":{"avgMonthlySearches":"4400","monthlySearchVolumes":[{"year":"2022","month":"FEBRUARY","monthlySearches":"5400"}],"competition":"LOW","competitionIndex":"2","lowTopOfPageBidMicros":"1047120","highTopOfPageBidMicros":"4240000"}}

"searchQuery":"dr house","closeVariants":["dr.house"]
"searchQuery":"c language","closeVariants":["c+language"]

Please add a similar "closeVariants" field to KeywordIdeas.


3. "keywordAnnotations" not for all words in KeywordIdeas

The words that I put in KeywordIdeas will always be the first in the response from the ADS API, but they will always have an empty "keywordAnnotations":[] field. Although if they are received as a list of words, this field will be filled with data.

set in KeywordIdeas:
"iphone 11 pro"

Example of first words of ADS API response:
{"text":"iphone 11 pro","keywordIdeaMetrics":{"avgMonthlySearches":"246000","monthlySearchVolumes":[{"year":"2022","month":"FEBRUARY","monthlySearches":"165000"}],"competition":"HIGH","competitionIndex":"100","lowTopOfPageBidMicros":"510000","highTopOfPageBidMicros":"3390000"},"keywordAnnotations":[]}

"keywordAnnotations":[]

If get ideas for word "iphone", then in the results the word "iphone 11 pro" will already have "keywordAnnotations".

An example of words that were not given in the payload:
{"text":"iphone 11 pro","keywordIdeaMetrics":{"avgMonthlySearches":"246000","monthlySearchVolumes":[{"year":"2022","month":"FEBRUARY","monthlySearches":"165000"}],"competition":"HIGH","competitionIndex":"100","lowTopOfPageBidMicros":"510000","highTopOfPageBidMicros":"3390000"},"keywordAnnotations":{"concepts":[{"name":"apple 11","conceptGroup":{"name":"Deviantart"}}]}}

"keywordAnnotations":{"concepts":[{"name":"apple 11","conceptGroup":{"name":"Deviantart"}}]}

Please add "keywordAnnotations" for the keywords that are being searched for in KeywordIdeas.

[Google Ads API Forum Advisor]

Hi Andrey,

Thank you for reporting all your findings! Regarding getting a 'Too many Requests error', the planning services have a limit on keyword planning requests of one per second, when the page size is small the return is so fast that you can a call again within the second, hence getting your error.

Regarding page size not working, I tried in REST and the amount asked for was the amount returned, just that at the end of every single page the same total amount is reported. It could be your setup automatically pulls the next page, or you are seeing the total amount available at the end of the first page.

If the above doesn't explain what you are experiencing could you privately provide us with logs of request and response to the API when log level is set to 'DEBUG' so that we can see what you are seeing?

The request and response appears similar to the JSON Mappings in our REST documentation. Our client libraries have loggers with logging instructions, to see these instructions you can click on the client library you use in the sidebar of our client library guide and click on "Logging". 

Regarding close Variants for keyword Ideas, I tried in the UI and there were no close variants returned for Keyword Ideas. The API can only be a conduit for the product as expressed in the UI. You may reach out to product support for your request. When it becomes available in the UI, could you privately send us a full screen screenshot of the UI showing close variants?

Regarding no annotations for the actual keyword, this looks like it is working as intended. The UI also doesn't have annotations for the actual keyword, if you deselect the annotation in the UI then you deselect all keywords except the ones you originally entered. This seems to be a method for filtering, not a method for categorizing.

Regards,

Aryeh Google Ads API Team

ref:_00D1U1174p._5004Q2ZJS3Z:ref