NegativeKeyword Data Object - Campaign Management

Defines a negative keyword with match type. A negative keyword can be added and deleted, but cannot be updated.

You may choose to assign negative keywords to an individual campaign or ad group. An assigned set of negative keywords cannot be shared with other campaigns or ad groups.

Negative keywords can also be added and deleted from a shared negative keyword list. The negative keyword list can be shared or associated with multiple campaigns.


The same negative keyword and match type can be added to all campaigns, ad groups, and negative keyword lists if you choose. Each instance must be added and associated individually and would be assigned a unique negative keyword identifier.

For more information about managing negative keywords and negative keyword lists, please see the technical guide about Negative Keywords.


<xs:complexType name="NegativeKeyword" xmlns:xs="">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:SharedListItem">
        <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
        <xs:element name="MatchType" type="tns:MatchType" />
        <xs:element name="Text" nillable="true" type="xs:string" />


Element Description Data Type
Id The unique Bing Ads identifier of the negative keyword.

Add: Read-only
MatchType The type of match to compare the negative keyword and the user's search term.

The supported values for a negative keyword are Exact and Phrase.

Add: Required
Text The negative keyword text. The text can contain a maximum of 100 characters.

Add: Required

The NegativeKeyword object has Inherited Elements.

Inherited Elements

Inherited Elements from SharedListItem

The NegativeKeyword object derives from the SharedListItem object, and inherits the following elements. The descriptions below are specific to NegativeKeyword, and might not apply to other objects that inherit the same elements from the SharedListItem object.

Element Description Data Type
ForwardCompatibilityMap The list of key and value strings for forward compatibility to avoid otherwise breaking changes when new elements are added in the current API version.

Forward compatibility changes will be noted here in future releases. There are currently no forward compatibility changes for the SharedListItem object.
KeyValuePairOfstringstring array
Type The type of the shared list item. This value is NegativeKeyword when you retrieve a negative keyword. For more information about shared list item types, see SharedListItem Data Object Remarks.

Add: Read-only


Service: CampaignManagementService.svc v11

Used By