# get/snapshots\_2/competitors

Last modified:
02/02/2021

## Method description

Use to get a list of competitors based on the collected SERP Snapshots.

This method is not applicable to the archived projects.

## Method parameters

| Parameter | Type | Description | Default |
|-----------|------|-------------|---------|
|Mandatory|
| project\_id | int | Project ID |  |
| region\_index | int | Region index |  |
| date1, date2 | date | The first and the last date of period |  |
|Additional|
| filters | array [filters](/content/api/v2/basic-params/filters/index.html)<br>of [keywords](/content/api/v2-services/keywords_2/keywords/index.html) | "Keyword" object filtering criterion |  |
| type\_range | enum( 3, 4) | Period<br>Available values:<br>- **3** \- two dates<br>- **4** \- one date | 3 |
| show\_exists\_dates | boolean | Include dates of keyword ranking checks | 0 |

## Returned data

| Parameter | Type | Description |
|-----------|------|-------------|
| result (object) |
| domains | object ( [qualifiers](/content/api/v2/fields/qualifiers/index.html) => object) | Competitors report |
| domains.summariesData | object ( [qualifiers](/content/api/v2/fields/qualifiers/index.html) => object) | Data for every check of each competitor |
| countKeywords | int | Keyword count |
| dates | array(date) | Dates of ranking checks included into the report |
| depthPositions | int | Collected Snapshots depth:<br>- **10**— TOP10;<br>- **20** — TOP20;<br>- **30** — TOP30;<br>- **40**— TOP40;<br>- **50** — TOP50;<br>- **100** — TOP100. |
| result.domains[N] |
| domain | string | Competitor domain |
| protocol | string | Competitor domain protocol |
| result.domains[N].summariesData[date:regionIndex] |
| avg | int | Average position |
| visibility | float | Visibility |
| tops | object | Number of keywords in TOPs<br>Object properties:<br>- **{NN}\_{NN}**— TOP intervals. By default the following intervals are available:<br>  <br>  - **1\_10** — TOP10<br>  - **11\_30** — TOP11‑30<br>  - **31\_50** — TOP31‑50<br>  - **51\_100** — TOP51‑100<br>- **absent** — TOP100+<br>- **all** — sum of all TOPs |