---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/reference/GetKeywordsSuggestion.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetKeywordsSuggestion.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/en/llms.txt

# GetKeywordsSuggestion
Returns suggestions for keywords.
## Restrictions

Points are used when this method is invoked (see [Point limitations](https://yandex.com/dev/direct/doc/dg-v4/en/concepts/Restrictions.md#Units)). If there are not enough points available, the error message [152](https://yandex.com/dev/direct/doc/dg-v4/en/reference/ErrorCodes.md#ErrorCode152) is returned.


## Input data {#input}

The input data structure in JSON is shown below.

```javascript
{
   "method": "GetKeywordsSuggestion",
   "param": {
      /* KeywordsSuggestionInfo */
      "Keywords": [
         (string)
         ...
      ]
   }
}
```

Parameters are described below.


#|
||
**<sup >Parameter</sup>**
|
**<sup >Description</sup>**
|
**<sup >Required</sup>**
||

||
**<sub >KeywordsSuggestionInfo object</sub>**
||
||
`Keywords`
|
Array of keywords that require suggestions (UTF-8 encoding).

Keywords may consist of several keywords. This method does not return suggestions if the words are from subject areas that are not related to each other, such as [refrigerator textbook].
|
Yes
||
|#


## Output data {#output}

The method returns suggestions for keywords (up to 20 keywords). The output data structure in JSON is shown below.

```javascript
{
   "data": [
      (string)
      ...
   ]
}
```


## Examples of input data {#example}

## Python

```python
{
 'Keywords': [u'refrigerator', u'unit']
}
```

## PHP

```php
array(
   'Keywords' => array('refrigerator', 'unit')
)>
```

## Perl

```perl
{
 'Keywords' => ['refrigerator', 'unit']
}>
```