---
title: KeywordSuggestion
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/keywordsuggestion
---

# KeywordSuggestion

A keyword suggestion returned by the keyword suggestions endpoint.

## Declaration

```data
object KeywordSuggestion
```

## Properties

text: The suggested keyword text. Read-only. popularity: Relative popularity score (not an absolute volume) for this keyword across App Store countries or regions. Read-only.

## Discussion

Discussion A KeywordSuggestion represents a single keyword text suggestion for an apps campaign. These suggestions are discovery tools. They surface keywords that may not already be in the ad group but are relevant to the app. Sort suggestions by popularity to add the highest-impact keywords first. Example {   "text": "productivity app",   "popularity": 85 }

## See Also

- [PhraseSuggestion](apple-ads-platform-api/phrasesuggestion.md)
- [CategorySuggestion](apple-ads-platform-api/categorysuggestion.md)
- [RecommendationQueryKeywordSuggestionResponse](apple-ads-platform-api/recommendationquerykeywordsuggestionresponse.md)
- [RecommendationQueryPhraseSuggestionResponse](apple-ads-platform-api/recommendationqueryphrasesuggestionresponse.md)
- [RecommendationQueryCategorySuggestionResponse](apple-ads-platform-api/recommendationquerycategorysuggestionresponse.md)
- [TargetCpaSuggestion](apple-ads-platform-api/targetcpasuggestion.md)
- [RecommendationQueryTargetCpaSuggestionResponse](apple-ads-platform-api/recommendationquerytargetcpasuggestionresponse.md)