<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/KeywordSuggestion",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:KeywordSuggestion"
  },
  "title" : "KeywordSuggestion"
}
-->

# KeywordSuggestion

A keyword suggestion returned by the keyword suggestions endpoint.

```
object KeywordSuggestion
```

## 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

```json
{
  "text": "productivity app",
  "popularity": 85
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)