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

# NegativeKeyword

A keyword exclusion that prevents ads from showing when a search query matches the excluded term.

## Declaration

```data
object NegativeKeyword
```

## Properties

adAccountId: The ad account this negative keyword belongs to. Informational. Read-only. campaignId: The campaign ID. Negative keywords can be defined at campaign or ad group level. Filterable (EQUALS). Immutable after creation. adGroupId: The ad group this negative keyword belongs to. Null if defined at campaign level. Filterable (EQUALS, IN, IS_NULL, IS_NOT_NULL, NOT_EQUALS). Immutable after creation. text: The original advertiser-given keyword text. Filterable (EQUALS, STARTS_WITH). Immutable after creation. matchType: Match type for this negative keyword. The schema accepts all four KeywordMatchType values (EXACT, BROAD, PHRASE, CATEGORY). In practice, EXACT and BROAD apply to App Store negatives and PHRASE applies to Apple Maps negatives. CATEGORY is not supported for negative keywords. See KeywordMatchType. Filterable (EQUALS, IN). Immutable after creation. status: Whether the negative keyword is active or paused. See NegativeKeywordStatus. Filterable (EQUALS, IN). Mutable. id: System-assigned unique identifier. Read-only. Filterable (EQUALS, IN). creationTime: Timestamp when the negative keyword was created. Read-only. modificationTime: Timestamp of the last modification. Read-only. deleted: Whether the negative keyword has been deleted. Read-only.

## Discussion

Discussion A NegativeKeyword prevents ads from showing when a search query matches the excluded term. The EXACT match negatives block only searches that precisely match the term. The BROAD match negatives block a wider range of related queries. The PHRASE match negatives block Apple Maps searches that match the term and close variants. Pausing a negative keyword (status: PAUSED) temporarily re-enables traffic from that term without permanently removing the exclusion. A deleted negative keyword is soft-deleted and excluded from serving but remains accessible in query results. You can use fields marked Filterable in the dictionary keys as filter criteria in query endpoint requests. See Calling the Apple Ads Platform API for details on constructing queries. Example {   "id": 777888999,   "adAccountId": 123456789,   "campaignId": 444555666,   "text": "free app",   "matchType": "BROAD",   "status": "ENABLED",   "creationTime": "2025-01-10T08:00:00.000",   "modificationTime": "2025-01-10T08:00:00.000",   "deleted": false }

## Topics

### Type Aliases

- [NegativeKeyword.MatchType](apple-ads-platform-api/negativekeyword/matchtype-data.typealias.md)
- [NegativeKeyword.Status](apple-ads-platform-api/negativekeyword/status-data.typealias.md)

## See Also

- [NegativeKeywordCreate](apple-ads-platform-api/negativekeywordcreate.md)
- [NegativeKeywordUpdate](apple-ads-platform-api/negativekeywordupdate.md)
- [NegativeKeywordResponse](apple-ads-platform-api/negativekeywordresponse.md)
- [NegativeKeywordQueryResponse](apple-ads-platform-api/negativekeywordqueryresponse.md)