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

# UpdatePrices
Sets bids and/or priorities for the specified keywords.

{% note alert %}

Disabled method. Use version 5 of the API.

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

{% endnote %}


The [UpdatePrices (Live)](https://yandex.com/dev/direct/doc/dg-v4/en/live/UpdatePrices.md) version also exists for this method.

Bid changes take effect after some time. See the [Ad Serving Rules](https://yandex.ru/legal/direct_display_rules/)[Ad Serving Rules](https://yandex.com/legal/direct_display_rules/).

## Restrictions

No more than 3000 method calls per campaign per day. You can set prices for a maximum of 1000 keywords in a single request.


{% note alert %}

This method only supports campaigns with the “Text & Image Ads” type. For setting bids in all types of campaigns, use the [Bids](https://yandex.com/dev/direct/doc/ref-v5bids/bids.md) service in version 5 of the API.

{% endnote %}



## Input data {#input}

The input data structure in JSON is shown below.

```javascript
{
   "method": "UpdatePrices",
   "param": [
      {  /* PhrasePriceInfo */
         "CampaignID": (int),
         "PhraseID": (long),
         "Price": (float),
         "AutoBroker": (string),
         "AutoBudgetPriority": (string),
         "ContextPrice": (float)
      }
      ...
   ]
}
```

The `param` parameter contains an array of `PhrasePriceInfo` objects (no more than 1000 objects), each of which sets prices for a single keyword. Parameters are described below.


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

||
**<sub >PhrasePriceInfo object</sub>**
||
||
`CampaignID`
|
The campaign ID.
|
Yes
||
||
`PhraseID`
|
The keyword ID.
|
Yes
||
||
`Price`
|
Bids on Yandex search.
|
At least one of the parameters: `Price`, `AutoBudgetPriority`, `ContextPrice`. Values of omitted parameters are not changed.
||
||
`ContextPrice`
|
Bid in the Yandex Advertising Network (in Yandex units). The bid can be set in the following cases:

1. The IndependentControl strategy is used on search. This strategy can only be selected via the Yandex Direct web interface.
1. A manual strategy is used on search and the keyword is disabled for a low CTR.
    
    For new keywords this condition is irrelevant, since keywords are no longer disabled for a low CTR.
||
||
`AutoBudgetPriority`
|
Priority of the keyword when using automatic strategies. Possible values:

- Low — Low priority.
- Medium — Average priority.
- High — High priority.
||
||
`AutoBroker`
|
Enable/disable AutoBroker. This parameter is not used, and the passed value is ignored.
|
No
||
|#


## Output data {#output}

Returns 1 when executed successfully, as shown in the following example.

```javascript
{
   "data": 1
}
```


## Examples of input data {#example}

## Python

```python
[
   {
      'CampaignID': 3665578,
      'PhraseID': 199381759,
      'Price': 6.5,
      'AutoBudgetPriority': 'Medium',
      'ContextPrice': 3.2
   }
]
```

## PHP

```php
array(
   array(
      'CampaignID' => 3665578,
      'PhraseID' => 199381759,
      'Price' => 6.5,
      'AutoBudgetPriority' => 'Medium',
      'ContextPrice' =3.2
   )
)
```

## Perl

```perl
[
   {
      'CampaignID' => 3665578,
      'PhraseID' => 199381759,
      'Price' => 6.5,
      'AutoBudgetPriority' => 'Medium',
      'ContextPrice' =3.2
   }
]
```

