---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/direct/doc/en/negativekeywordsharedsets/get.md
  - https://yandex.ru/dev/direct/doc/ru/negativekeywordsharedsets/get.md
  - href: en/negativekeywordsharedsets/get.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/ref-v5/negativekeywordsharedsets/get.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/direct/doc/en/llms.txt

# get

Returns sets of negative keywords.

## Learn more

- [How the "get" method works](https://yandex.com/dev/direct/doc/best-practice/get.html)


## Request {#input}

Request structure in JSON format:

```javascript translate=no
{
  "method": "get",
  "params": { /* params */
    "SelectionCriteria": {  /* IdsCriteria */
      "Ids": [(long), ... ] /* required */
    },
    "FieldNames": [( "Id" | "Name" | "NegativeKeywords" | "Associated" ), ... ] /* required */
    "Page": {  /* LimitOffset */
      "Limit": (long),
      "Offset": (long)
    }
  }
}
```


#|
||
**Parameter**
|
**Type**
|
**Description**
|
**Required**
||

||
**params structure (for JSON) / GetRequest (for SOAP)**
||
||
`SelectionCriteria`
|
IdsCriteria
|
Criteria for selecting sets of negative keywords. If omitted, all sets of negative keywords that belong to the user will be returned.
|
No
||
||
`FieldNames`
|
array of NegativeKeywordSharedSetFieldEnum
|
Names of top-level parameters to get.
|
Yes
||
||
`Page`
|
[LimitOffset](https://yandex.com/dev/direct/doc/best-practice/get.html#LimitOffset)
|
Structure that defines the page for [paginated selection](https://yandex.com/dev/direct/doc/best-practice/get.html) of data.
|
No
||

||
**IdsCriteria structure**
||
||
`Ids`
|
array of long
|
Selects sets of negative keywords with the specified IDs. Maximum of 30 items in the array.
|
Yes
||
|# 


## Response {#output}

Response structure in JSON format:

```javascript translate=no
{
  "result": { /* result */
    "NegativeKeywordSharedSets": [{  /* NegativeKeywordSharedSetGetItem */
      "Id": (long),
      "Name": (string),
      "NegativeKeywords": [(string), ... ],
      "Associated": ( "YES" | "NO" )
    }, ... ],
    "LimitedBy": (long)
  }
}
```


#|
||
**Parameter**
|
**Type**
|
**Description**
||

||
**result structure (for JSON) / GetResponse (for SOAP)**
||
||
`NegativeKeywordSharedSets`
|
array of NegativeKeywordSharedSetGetItem
|
Sets of negative keywords.
||
||
`LimitedBy`
|
long
|
Sequential number of the last object returned. It is included if there was a limit on the number of objects in the response. See the section [Paginated data selection](https://yandex.com/dev/direct/doc/best-practice/get.html).
||

||
**NegativeKeywordSharedSetGetItem structure**
||
||
`Id`
|
long
|
ID of the set of negative keywords.
||
||
`Name`
|
string
|
Name of a set of negative keywords (maximum 255 characters).
||
||
`NegativeKeywords`
|
array of string
|
Array of negative keywords.

<!-- source: en/_includes/adgroups/add/id-input/negative-keyword-rule1.md -->
A keyword should be specified without the minus sign before the first word.

Maximum of 7 words per keyword. The maximum length of each word is 35 characters. The maximum combined length of negative keywords in the array is 4096 characters. Spaces, dashes, and operators are not counted as part of the total length.
<!-- endsource: en/_includes/adgroups/add/id-input/negative-keyword-rule1.md -->
||
||
`Associated`
|
YesNoEnum
|
Whether the set of negative keywords is assigned to at least one ad group.
||
|#