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

# Get
Returns retargeting parameters.

{% note alert %}

Disabled method. Use version 5 of the API.

For information about the compatibility of methods between versions Live 4 and 5, see the [Migration guide](https://yandex.com/dev/direct/doc/migration/concepts/methods.md).

{% endnote %}


## Input data

The input data structure in JSON is shown below.

```javascript
{
   "method": "Retargeting",
   "param": {
      /* RetargetingRequest */
      "Action": (string),
      "Login": (string),
      "SelectionCriteria": {
         /* RetargetingSelectionCriteria */
         "RetargetingConditionIDS": [
            (int)
            ...
         ],
         "RetargetingIDS": [
            (int)
            ...
         ],
         "AdIDS": [
            (long)
            ...
         ]
      },
      "Options": {
        "Currency": (string)
      }
   }
}
```

Parameters are described below.


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

||
**<sub >RetargetingRequest object</sub>**
||
||
`Action`
|
Action: Get.
|
Yes
||
||
`Login`
|
The username of the client to get the retargeting for.

For advertisers, this parameter is ignored.
|
For agencies
||
||
`SelectionCriteria`
|
The `RetargetingSelectionCriteria` object, which sets criteria for selecting retargetings.
|
Yes
||
||
`Options`
|
The `RetargetingRequestOptions` object, which sets response parameters.
|
Yes
||

||
**<sub >RetargetingSelectionCriteria object</sub>**
||
||
`RetargetingConditionIDS`
|
Array of IDs of retargeting conditions to perform the operation for. Maximum of 1000 items in the array.
|
One of the parameters `RetargetingConditionIDS`, `RetargetingIDS` or `AdIDS`
||
||
`RetargetingIDS`
|
Array of retargeting IDs to perform the operation for. Maximum of 1000 items in the array.
||
||
`AdIDS`
|
Array of ad IDs to perform the operation for. Maximum of 1000 items in the array.
||

||
**<sub >RetargetingRequestOptions object</sub>**
||
||
`Currency`
|
The currency to use for bids in the response.

Acceptable values: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN. The value must match the campaign currency; otherwise, an error is returned with code [245](https://yandex.com/dev/direct/doc/dg-v4/en/reference/ErrorCodes.md#BadCurrency).
|
Yes
||

||
**Notes**
||
||
If the `SelectionCriteria` structure has more than one criterion set, the operation will be performed for those retargetings that simultaneously match all the criteria. For example, if the parameters `RetargetingConditionIDS` and `AdIDS` are set, the operation will be made for retargetings that have a condition ID that is in the `RetargetingConditionIDS` array, and an ad ID that is in the `AdIDS` array.
||
|#

## Output data

The output data structure in JSON is shown below.

```javascript
{
   "data": {
      /* RetargetingResponse */
      "Retargetings": [
         {  /* Retargeting */
            "RetargetingID": (int),
            "AdID": (long),
            "AdGroupID": (long),
            "RetargetingConditionID": (int),
            "ContextPrice": (float),
            "Currency": (string),
            "AutoBudgetPriority": (string),
            "StatusPaused": (string)
         }
         ...
      ]
   }
}
```

Parameters are described below.


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

||
**<sub >RetargetingResponse object</sub>**
||
||
`Retargetings`
|
Array of `Retargeting` objects.
||

||
**<sub >Retargeting object</sub>**
||
||
`RetargetingID`
|
ID of the retargeting.
||
||
`AdGroupID`
|
ID of the ad group.
||
||
`AdID`
|
The ad ID.
||
||
`RetargetingConditionID`
|
ID of the retargeting condition.
||
||
`ContextPrice`
|
Bid for the Yandex Advertising Network when using the MaximumCoverage and Default strategies (in the currency specified in the `Currency` parameter).
||
||
`Currency`
|
The currency the bid is shown in.

Acceptable values: RUB, CHF, EUR, KZT, TRY, UAH, USD, BYN.
||
||
`AutoBudgetPriority`
|
Priority of the retargeting when using automatic strategies. Possible values:

- Low — Low priority.
- Medium — Average priority.
- High — High priority.
||
||
`StatusPaused`
|
Retargeting is temporarily disabled (not used for displaying ads) — Yes/No. The predefined value is No.
||
|#

## Examples of input data

# Python

```python
{
   'Action': 'Get',
   'SelectionCriteria': {
      'AdIDS': [2571703, 2571705, 2571707]
   }
}
```

# PHP

```php
array(
   'Action' => 'Get',
   'SelectionCriteria' => array(
      'AdIDS' => array(2571703, 2571705, 2571707)
   )
)
```

# Perl

```perl
{
   'Action' => 'Get',
   'SelectionCriteria' ={
      'AdIDS' => [2571703, 2571705, 2571707]
   }
}
```

## Related information

- [Retargeting](https://yandex.com/dev/direct/doc/dg-v4/en/concepts/retargeting.md)