---
title: Query Category 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-category-suggestions
---

# Query Category Suggestions

Query category suggestions for apps or brands using either a discovery or search route based on the query type.

## URL

POST https://api.ads.apple.com/v1/suggestions/categories/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 result is a CategorySuggestion object with a category name (for example, "Productivity") and a popularity 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 discovers category suggestions for a brand using the SUGGESTION route. The response is a list of category names with their relative popularity scores. The same route also works for apps, using APPSTORE_APP as the promotedObjectType.

## HTTP Body

See RecommendationQueryRequest. This endpoint supports two query routes selected by the queryType filter: SUGGESTION discovers categories for a specific app or brand, and SEARCH looks up or searches categories by name.

## See Also

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