Get search volumes for all available months

[Xinyi Guo]

Hi, I noticed Google Ads API monthly_search_volumes[] only provides search volume of a query for the past 12 months.

https://developers.google.com/google-ads/api/reference/rpc/v9/KeywordPlanHistoricalMetrics

But in the Keyword Planner tool it is possible to pull search volume of all available months for almost 4 years.

https://www.screencast.com/t/1yfc2WXs7U

Is there a way to pull the same data through API?

Thanks.

Best,

Corrine

[Google Ads API Forum Advisor]

Hello Xinyi,

Thanks for reaching out to the Google Ads API support. MonthlySearchVolume on the Google Ads API provides only the number of searches for the past twelve months. Please refer to the attached documentation for further details. However, you can use the segmentation on the segments field to retrieve the records that are older than 12 months. Sharing an example of segmentation below : 
Example query: “SELECT campaign.name, metrics.clicks, segments.quarter, segments.month 
FROM campaign
WHERE segments.year > 2015
  AND segments.year < 2020”
Hope this helps, feel free to reply if you have any follow-up questions.

Best regards,

Jakeia Sabrina Google Ads API Team

 

ref:_00D1U1174p._5004Q2UiJmC:ref

[Xinyi Guo]

Hi Jakeia,

My understanding is that the segmentation can only retrieve campaign data from earlier period, but for search volume I need to create new campaign and ad groups. I am not sure how the old search volume can be retrieved through the segmentation?

Best,

Xinyi

[Google Ads API Forum Advisor]

Hello Xinyi,

Thanks for getting back to us.

According to this guide, avg_monthly_searches will only provide an averaged for the past 12 months. Since you've mentioned that the Keyword Planner tool is possible to pull search volume of all available months for almost 4 years, allow me to raise a feature request for this instead (subject for review). Since there is no guarantee if this will be supported in the API soon, we recommend that you keep an eye to our blog for updates and new releases.

Regards,

Mark Kevin Albios Google Ads API Team

ref:_00D1U1174p._5004Q2UiJmC:ref

[Xinyi Guo]

Hey Mark,

Thanks for the reply. That'll be something really helpful.

Look forward to having it soon!

Best,

Xinyi

[Google Ads API Forum Advisor]

Hi Xinyi,

Does the HistoricalMetricsOptions YearMonthRange satisfy your request? It states:

The year month range for historical metrics. If not specified the searches will be returned for past 12 months. Searches data is available for the past 4 years. If the search volume is not available for the entire year_month_range provided, the subset of the year month range for which search volume is available will be returned.

Feel free to get back to us.

Regards,

Aryeh Baker Google Ads API Team

ref:_00D1U1174p._5004Q2UiJmC:ref