---
title: "GET /negative_keyword"
method: GET
path: "/negative_keyword"
tags: ["negative_keyword"]
---

# GET /negative_keyword

`GET /negative_keyword`

<span class="tablenote"><b>Note:</b> This method is only available for select partners who have been approved for the eBay Promoted Listings Advanced (PLA) program. For information about how to request access to this program, refer to <a href="/api-docs/sell/static/marketing/pl-verify-eligibility.html#access-requests " target="_blank "> Promoted Listings Advanced Access Requests</a> in the Promoted Listings Playbook. To determine if a seller qualifies for PLA, use the <a href="/api-docs/sell/account/resources/advertising_eligibility/methods/getAdvertisingEligibility " target="_blank ">getAdvertisingEligibility</a> method in Account API.</span><br />This method can be used to retrieve all of the negative keywords for ad groups in PLA campaigns that use the Cost Per Click (CPC) funding model.<br /><br />The results can be filtered using the <b>campaign_ids</b>, <b>ad_group_ids</b>, and <b>negative_keyword_status</b> query parameters.<br /><br />Call the <a href="/api-docs/sell/marketing/resources/campaign/methods/getCampaigns">getCampaigns</a> method to retrieve a list of current campaign IDs for a seller.

## Query parameters

- `ad_group_ids` string
- `campaign_ids` string
- `limit` string
- `negative_keyword_status` string
- `offset` string

## Response `200`

Success

- NegativeKeywordPagedCollectionResponse — A type that defines the negative keywords, returned in a paged collection.
  - `href` string — The URI of the current page of results from the result set.
  - `limit` integer — The number of items returned on a single page from the result set. This value can be set in the request with the <b>limit</b> query parameter.
  - `negativeKeywords` NegativeKeyword[] — A list of negative keywords returned in the paginated collection.
    - `adGroupId` string — An ad group ID that is generated when an ad group is first created and associated with a campaign.<br /><br /><span class="tablenote"><b>Note:</b> You can call the <a href="/api-docs/sell/marketing/resources/adgroup/methods/getAdGroups">getAdGroups</a> method to retrieve the ad group IDs for a seller.</span>
    - `campaignId` string — A unique eBay-assigned ID for a campaign. This ID is generated when a campaign is created.
    - `negativeKeywordId` string — A unique eBay-assigned ID for a negative keyword. This keyword ID will be generated for each successfully created negative keyword.
    - `negativeKeywordMatchType` string — A field that defines the match type for the negative keyword.<br /><br /><span class="tablenote"><span style="color:#004680"><strong>Note:</strong></span> Broad matching of negative keywords is not currently supported.</span><br /><b>Valid Values:</b><ul><li><code>EXACT</code></li><li><code>PHRASE</code></li></ul> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:NegativeKeywordMatchTypeEnum'>eBay API documentation</a>
    - `negativeKeywordStatus` string — A field that defines the status of the negative keyword. For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/marketing/types/pls:NegativeKeywordStatusEnum'>eBay API documentation</a>
    - `negativeKeywordText` string — The text for the negative keyword.
  - `next` string — The call URI that can be used to retrieve the next page in the result set. This value is returned only if there is an additional page of results to display from the result set.
  - `offset` integer — The number of results skipped in the result set before listing the first returned result. This value can be set in the request with the <b>offset</b> query parameter.<br /><br /><b>Default:</b> <code>0</code><br /><br /><span class="tablenote"><b>Note: </b>The items in a paginated result set use a zero-based list, where the first item in the list has an offset of <code>0</code>.</span>
  - `prev` string — The call URI that can be used to retrieve the previous page in the result set. Basically, all of the request parameters will remain the same except the offset value, which will be decreased to retrieve the previous page of results.
  - `total` integer — The total number of result sets in the paginated collection.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Business error
- `500` — Internal Server error

---

[API](https://skmtc.net/ebay/apis/sell-marketing.md) · [All operations](https://skmtc.net/ebay/apis/sell-marketing/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ebay/sell-marketing/versions/de10a5d47510/schema)