> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v24** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/reference/rpc/latest/KeywordPlanIdeaService/GenerateKeywordHistoricalMetrics).

<button default="" value="grpc">gRPC</button> <button value="rest">REST</button>

| ### GenerateKeywordHistoricalMetrics |
|---|
| `` rpc GenerateKeywordHistoricalMetrics(`GenerateKeywordHistoricalMetricsRequest`) returns (`GenerateKeywordHistoricalMetricsResponse`) `` Returns a list of keyword historical metrics. List of thrown errors: [AuthenticationError](https://developers.google.com/google-ads/api/reference/rpc/v24/AuthenticationErrorEnum.AuthenticationError.md.txt) [AuthorizationError](https://developers.google.com/google-ads/api/reference/rpc/v24/AuthorizationErrorEnum.AuthorizationError.md.txt) [CollectionSizeError](https://developers.google.com/google-ads/api/reference/rpc/v24/CollectionSizeErrorEnum.CollectionSizeError.md.txt) [HeaderError](https://developers.google.com/google-ads/api/reference/rpc/v24/HeaderErrorEnum.HeaderError.md.txt) [InternalError](https://developers.google.com/google-ads/api/reference/rpc/v24/InternalErrorEnum.InternalError.md.txt) [QuotaError](https://developers.google.com/google-ads/api/reference/rpc/v24/QuotaErrorEnum.QuotaError.md.txt) [RequestError](https://developers.google.com/google-ads/api/reference/rpc/v24/RequestErrorEnum.RequestError.md.txt) [Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v24/services/keyword_plan_idea_service.proto) |

Authorization scopes

:   Requires the following OAuth scope:

    - `https://www.googleapis.com/auth/adwords`

    For more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).