--- title: Query Negative Keywords framework: Apple Ads Platform API role: symbol role_heading: Web Service Endpoint platforms: [apple ads platform api 1.0+] path: apple-ads-platform-api/post-negative-keywords-query --- # Query Negative Keywords Query negative keywords using structured filters, sorting, and pagination. ## URL POST https://api.ads.apple.com/v1/negative-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 This endpoint queries negative keywords using a standard QueryRequest body. The adGroupId field is always required. The API returns an error if it is omitted. The adGroupId EQUALS or adGroupId IN filter scopes the query to one or more specific ad groups. The campaignId field is optional with these operators. The adGroupId IN filter accepts up to 1000 values. The adGroupId IS_NULL filter combined with a campaignId EQUALS filter returns only campaign-level negatives. The adGroupId IS_NOT_NULL filter combined with a campaignId EQUALS filter returns only ad-group-level negatives across the campaign. The adGroupId NOT_EQUALS filter combined with a campaignId EQUALS filter returns ad-group-level negatives, excluding the specified ad group. The campaignId field only supports EQUALS. Filtering by id (EQUALS or IN) is exempt from the adGroupId requirement, since id already fully bounds the query. See QueryFilterOperator for the full set of supported comparison operators. Filterable Fields | | | | | | | | | | | | | | | | | | | | | | | | | | | | The request body is a QueryRequest composed of QueryFilter conditions and QuerySort directives (QuerySortOrder), controlled by QueryPagination. Payload Examples ## See Also - [Create a Negative Keyword](apple-ads-platform-api/post-negative-keywords.md) - [Get a Negative Keyword](apple-ads-platform-api/get-negative-keywords-_id_.md) - [Update a Negative Keyword](apple-ads-platform-api/put-negative-keywords-_id_.md) - [Delete a Negative Keyword](apple-ads-platform-api/delete-negative-keywords-_id_.md)