---
title: Query Keyword Suggestions
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/query-keyword-suggestions
---

# Query Keyword Suggestions

Query keyword suggestions based on search terms and App Store countries or regions using structured filters.

## URL

POST https://api.ads.apple.com/v1/suggestions/keywords/query

## Header Parameters

X-Ap-Context:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 Too Many Requests: 500 Internal Server Error:

## Discussion

Discussion Each KeywordSuggestion result contains text (the suggested keyword string) and popularity (a relative score). Sort by popularity DESC and use pagination to page through results. See FilterOperator for the full set of supported comparison operators. Filterable Fields  |  |  |   |  |  |   |  |  |   |  |  |   |  |  |  Payload Examples This example queries keyword suggestions for an app scoped to the US and GB App Store countries or regions, seeded by specific search terms. The response returns suggested keyword strings with their relative popularity scores.

## HTTP Body

See RecommendationQueryRequest.

## See Also

- [Query Phrase Suggestions](apple-ads-platform-api/query-phrase-suggestions.md)
- [Query Category Suggestions](apple-ads-platform-api/query-category-suggestions.md)
- [Query Target CPA Suggestion](apple-ads-platform-api/query-target-cpa-suggestion.md)