# get/positions_2/checker/price

Last modified:
02/02/2021

## Method description

Retrieve the cost of a keyword ranking check.

Get structured results grouped out by a project owner.

This method cannot be applied to the archived projects.

## Method parameters

| Parameter                | Type           | Description                                                                                                                                                       | Default                             |
|--------------------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------|
| Mandatory                |                |                                                                                                                                                                   |                                     |
| filters                  | array          | [filters](/content/api/v2/basic-params/filters/index.html) of [projects](/content/api/v2-services/projects_2/projects/index.html) |                                     |
| Additional               |                |                                                                                                                                                                   |                                     |
| regions_indexes          | array(int)     | Region index (filter)                                                                                                                                           |                                     |
| folders_ids              | array(int)     | Folder ids (filter)                                                                                                                                             |                                     |
| folders_ids_depth        | boolean        | Check subfolders when filter by folder ID applied                                                                                                              | 0                                   |
| groups_ids               | array(int)     | Groups ids (filter)                                                                                                                                             |                                     |
| do_snapshots             | enum(0, 1)     | Snapshots tool depth (has higher priority than the project settings). Available options: <br>- **0** — do not collect snapshots; <br>- **1** — collect SERP Snapshots TOP‑100 in Yandex and the same TOP as depth in Google. | Project settings value              |
| keyword_id               | int            | keyword ID (filter)<br>- cannot be used in a bulk update<br>- **regions_indexes** mandatory<br>- **groups_ids** ignored                                        |                                     |
| apply_discount           | boolean        | Applies discount and returns an amount                                                                                                                         | 1                                   |

## Returned data

| Parameter                | Type           | Description                                                                                                       |
|--------------------------|----------------|-------------------------------------------------------------------------------------------------------------------|
| result                   | object         |                                                                                                                   |
| pricesByUsers            | object         | Object stores ranking check cost grouped out by a project owner                                                  |
| result.pricesByUsers     |                |                                                                                                                   |
| %userId%                | object         | Object stores ranking check cost for a selected user                                                              |
| result.pricesByUsers.%userId% |                |                                                                                                                   |
| projectsIds              | array(int)     | selected project IDs                                                                                             |
| price                    | float          | Ranking check cost                                                                                               |

## More on the topic

[Service: Rankings (positions_2)](/content/api/v2-services/positions_2/index.html)