Keys.so API (1.0)

API интерфейс используется для того, чтобы интегрировать возможности сервиса Keys.so в личный проект клиента. API предназначен для разработчиков и сопровождается детальной документацией.

Описание

REST API сервиса работает по протоколу HTTP и представляет собой набор методов, с помощью которых совершаются запросы и возвращаются ответы для каждой операции. Все ответы приходят в виде JSON структур.

Авторизация

Процесс авторизации возможен при наличии персонального ключа (далее токен), которым в дальнейшем должен быть подписан каждый запрос к API.

Токен можно сформировать в настройках личного кабинета в блоке API.

Токен автоматически будет обновлен в случае смены пароля пользователя или по нажатию кнопки 'Сформировать новый токен'.

Стандартные параметры запроса

Большинство отчетов (если об этом не сказано отдельно) поддерживают стандартные параметры запроса:

Параметр	Тип	Обязательный	Описание	Значение по умолчанию
current_page	integer	false	Порядковый номер страницы результатов	1
per_page	integer	false	Количество результатов на одной странице	25
sort	string	false	Сортировка данных по полям Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Пример значения: `pos\|asc` Пример значения сортировки по двум полям: `pos\|asc,wsk\|desc`	none
filter	string	false	Подробнее про фильтрацию смотрите в разделе Фильтрация данных	none

Фильтрация данных

Механизм фильтрации используется вместе с параметрами запроса по умолчанию.
Поля, которые поддерживают фильтрацию, перечислены в документации каждого отчета.

Тип поля	Условие	Оператор, формат
string, integer	Строго равен	field`=`value
string, integer	Строго не равен	field`!=`value
string	Похож	field`LIKE`value
string	Не похож	field`NOT LIKE`value
string	Начинается с	field`STARTSWITH`value
string	Заканчивается	field`ENDSWITH`value
string, integer	Один из	field`IN`valueA,valueB
string, integer	Не один из	field`NOT IN`valueA,valueB
integer	Больше чем	field`>`value
integer	Меньше чем	field`<`value
integer	Больше или равно	field`>=`value
integer	Меньше или равно	field`<=`value
integer	Между	field`BETWEEN`valueA@valueB
string	Содержит	field`REGEXP`value
string	Не содержит	field`NOT REGEXP`value

Дашборд

Информация о домене (Дашборд)

Пример запроса: https://api.keys.so/report/simple/domain_dashboard?base=msk&domain=wildberries.ru

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

domain

required

string

Имя домена

Responses

Response samples

200

Content type

application/json

{"id": 29918348,
"name": "wildberries.ru",
"parentid": 0,
"parentName": "",
"childsCount": 18,
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529,
"restop5": 27,
"topvis": 141,
"topkeys": 99,
"pagesinindex": 117711,
"vis": 110373,
"adtraf": 33507,
"adcost": 1110959,
"adscnt": 16075,
"adkeyscnt": 732392,
"keys": [{"word": "интернет магазин",
"ws": 31497995,
"wsk": 185018,
"pos": 1
}
],
"concs": [{"did": 14791338,
"name": "yandex.ru",
"cnt": 1304735,
"perc": 2.23,
"vis": 9013545
}
],
"pages": [{"url": "/content/size.html",
"it50": 5321
}
],
"ads": [{"id": 1424,
"header": "Модные шапки - коллекция 2017 – Более 30000 моделей",
"txt": "Скидки до 70% бесплатная курьерская доставка по России",
"links": "Шапки для детей|Шапки для женщин|Шапки для мужчин",
"facts": "string",
"keyscnt": 5321
}
],
"adkeys": [{"word": "вайлдберриз",
"ws": 499918,
"wsk": 763146,
"pos": 0,
"avbid": 65,
"p": [0,
31
],
"sr": 0
}
],
"adconcs": [{"did": 14791338,
"name": "lamoda.ru",
"cnt": 436412,
"adscnt": 44592,
"adkeyscnt": 1099981,
"vis": 3520115
}
],
"history": {"2023.01": [84193,
1436310,
2503950,
4291083,
8481977,
998543,
37360,
491351,
1556892
]
},
"linksHistory": {"2024.04": [3979306,
72441715,
37555,
18,
11246
]
}
}

Информация о ключевом слове (Дашборд)

Пример запроса: https://api.keys.so/report/simple/keyword_dashboard?keyword=%D0%9F%D0%BB%D0%B0%D1%81%D1%82%D0%B8%D0%BA%D0%BE%D0%B2%D1%8B%D0%B5%20%D0%BE%D0%BA%D0%BD%D0%B0&base=msk

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

keyword

required

string

Поисковый запрос

Responses

Response samples

200

Content type

application/json

{"id": 29918348,
"word": "пластиковые окна",
"ws": 31497995,
"wsk": 185018,
"isgeo": 0,
"isquest": 0,
"top": [{"did": 14791338,
"delta": 0,
"churl": 0,
"pos": 1,
"domain": "vekamoscow.ru",
"url": "/windows-calc/",
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529,
"pit1": 86990,
"pit5": 455279,
"pit10": 742944,
"pit50": 1683529,
"adsenseid": "0",
"analytics": 65128131,
"vis": 276
}
],
"ads": [{"did": 14791338,
"bid": 5,
"header": "Пластиковые окна КАЛЕВА! – Скидка 23%! От производителя!",
"amn": 32,
"txt": "Окна от производителя. Индикатор погоды METEOGLASS в подарок! Замер 0 руб. Звоните!",
"facts": ["string"
],
"links": ["string"
],
"cpc_min": "0",
"cpc_max": "0",
"domain": "fabrikaokon.ru\""
}
],
"similar": [{"word": "пластиковые окна бесплатно",
"kid": 31497995,
"cnt": 31,
"ws": 31497995,
"wsk": 185018,
"docs": 38000000,
"avbid": 5
}
]
}

Групповые отчеты

Список групповых отчетов

Пример запроса https://api.keys.so/report/group/list?sort=access_date%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"rid": "3aa8f6a2603adc6fe499d42dcf82a4c8",
"name": "asa1d",
"base": "msk",
"create_date": "2024-04-22 04:03:15",
"access_date": "2024-04-22 04:03:27",
"state": 10,
"owner": "[email protected]",
"canDelete": true,
"canChangeOwner": true
}
]
}

Создание отчета

Создание отчета и получение идентификатора, который понадобится в дальнейшем для взаимодействия с отчетом.

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json
required

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domains required	Array of strings Массив доменов в отчете
name	any Имя отчета

Responses

Request samples

Payload

Content type

application/json

{"base": "msk",
"domains": [["keys.so",
"dodopizza.ru"
]
],
"name": null
}

Response samples

200

Content type

application/json

{"rid": "696b62ec6bceaf00529c4dd4bce02b47"
}

Статус обработки отчета

Пример запроса https://api.keys.so/report/group/state/090e6fcc65ea67fcc8f0bd00ade39a

Authorizations:

X-Keyso-TOKENauth-token

Responses

Response samples

200

Content type

application/json

{"state": 10,
"progress": 100
}

Домены в отчете

Пример запроса https://api.keys.so/report/group/organic/keywords/3aa8f62903adc6fe499d42dcf82a4c8?sort=it50%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

rid

required

string

Идентификатор отчёта

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": "dodopizza.ru",
"name": "dodopizza.ru",
"path": "/",
"it1": 86990,
"it3": 302770,
"it5": 45527,
"it10": 742944,
"it50": 1683529,
"pagesinindex": 117711,
"vis": 110373,
"adscnt": 16075,
"adkeyscnt": 732392,
"adtraf": 33507,
"adcost": 1110959
}
]
}

Органическая выдача - ключевые слова группы

Пример запроса https://api.keys.so/report/group/organic/keywords/696b62ec6bceaf00529c4dd4bce02b47?sort=wsk%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

rid

required

string

Идентификатор отчёта

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 31497995,
"avbid": 5,
"word": "одежда для беременных интернет магазин недорогая",
"weight": 4,
"ws": 31497995,
"wsk": 185018,
"numwords": 6,
"isgeo": 6,
"isquest": 6
}
]
}

Органическая выдача - конкуренты группы

Пример запроса https://api.keys.so/report/group/organic/concurents/696b62ec6bceaf00529c4dd4bce02b47?sort=cnt%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

rid

required

string

Идентификатор отчёта

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 31497995,
"name": "wildberries.ru",
"perc": 28.1,
"cnt": 479138,
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529,
"pagesinindex": 117711,
"vis": 110373,
"adscnt": 16075,
"adkeyscnt": 732392,
"adtraf": 33507,
"adcost": 1110959
}
]
}

Органическая выдача - страницы группы

Пример запроса https://api.keys.so/report/group/organic/sitepages/696b62ec6bceaf00529c4dd4bce02b47?sort=vis%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

rid

required

string

Идентификатор отчёта

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"domain": "likewear.ru",
"url": "/content/size.html",
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529,
"vis": 110373
}
]
}

Контекстная реклама - ключевые слова группы

Пример запроса https://api.keys.so/report/group/context/keywords/696b62ec6bceaf00529c4dd4bce02b47?sort=weight%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

rid

required

string

Идентификатор отчёта

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 31497995,
"weight": 4,
"ws": 191654,
"wsk": 2289,
"numwords": 2,
"isgeo": 0,
"isquest": 0,
"avbid": 5
}
]
}

Контекстная реклама - конкуренты группы

Пример запроса https://api.keys.so/report/group/context/concurents/696b62ec6bceaf00529c4dd4bce02b47?sort=cnt%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

rid

required

string

Идентификатор отчёта

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 31497995,
"name": "wildberries.ru",
"perc": 28.1,
"cnt": 479138,
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529,
"pagesinindex": 117711,
"vis": 110373,
"adscnt": 16075,
"adkeyscnt": 732392,
"adtraf": 33507,
"adcost": 1110959
}
]
}

Контекстная реклама - объявления группы

Пример запроса https://api.keys.so/report/group/context/ads/696b62ec6bceaf00529c4dd4bce02b47?sort=keyscnt%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

rid

required

string

Идентификатор отчёта

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"aid": 234121,
"domain": "okna-home.com",
"header": "Пластиковые окна КАЛЕВА! – Скидка 23%! От производителя!",
"txt": "Окна от производителя. Индикатор погоды METEOGLASS в подарок! Замер 0 руб. Звоните!",
"links": ["string"
],
"facts": ["string"
],
"keyscnt": 1
}
]
}

Контекстная реклама - объявления, уникальные ссылки группы

Пример запроса https://api.keys.so/report/group/context/ads/links/696b62ec6bceaf00529c4dd4bce02b47?sort=cnt%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

rid

required

string

Идентификатор отчёта

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"links": "Вечерние платья"
}
]
}

Контекстная реклама - объявления, уникальные факты группы

Пример запроса https://api.keys.so/report/group/context/ads/facts/696b62ec6bceaf00529c4dd4bce02b47?sort=cnt%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

rid

required

string

Идентификатор отчёта

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"facts": "Более 10 лет на рынке"
}
]
}

Органическая выдача

Органическая выдача - конкуренты

Пример запроса https://api.keys.so/report/simple/organic/concurents?base=msk&domain=wildberries.ru&sort=cnt%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 14791338,
"name": "wildberries.ru",
"perc": 28.1,
"theme": 34.7,
"cnt": 479138,
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529,
"pagesinindex": 117711,
"vis": 110373,
"adscnt": 16075,
"adkeyscnt": 732392,
"adtraf": 33507,
"adcost": 1110959
}
]
}

Органическая выдача - конкуренты страницы

Пример запроса https://api.keys.so/report/simple/organic/concurent_pages?base=msk&domain=wildberries.ru&page_url=%2Fbrands%2Fadidas&sort=pos%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
page_url required	string Url страницы
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"did": 14791338,
"domain": "wildberries.ru",
"url": "/shop/producer/6334/sort/a/page/1.htm",
"perc": 28.1,
"theme": 34.7,
"cnt": 479138,
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529
}
]
}

Органическая выдача - cтраницы

Пример запроса https://api.keys.so/report/simple/organic/sitepages?base=msk&domain=wildberries.ru&sort=it50%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"url": "/content/size.html",
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529,
"vis": 110373,
"new_url": 0,
"found_date": "11.06.2023"
}
]
}

Органическая выдача - ключевые слова

Пример запроса https://api.keys.so/report/simple/organic/keywords?base=msk&domain=wildberries.ru&sort=pos%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"word": "ecco remote отзывы",
"url": "/catalog/464638/detail.aspx",
"ws": 14791338,
"wsk": 86990,
"pos": 0,
"numwords": 5,
"adscnt": 16075,
"docs": 732392,
"avbid": 5,
"isgeo": 0,
"isquest": 0,
"nw": 0,
"delta": 0,
"churl": 0,
"wizardscount": 0,
"wizards": {"43": "карта"
},
"kid": 572850182,
"did": 261720522,
"serpf": "10.06.2024"
}
]
}

Органическая выдача - ключевые слова по странице

Пример запроса https://api.keys.so/report/simple/organic/keywords/bypage?base=msk&domain=wildberries.ru&page_url=%2Fbrands%2Fadidas&sort=pos%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
page_url required	string Url страницы
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"word": "бенеттон официальный сайт",
"ws": 14791338,
"wsk": 86990,
"pos": 0,
"numwords": 5,
"adscnt": 16075,
"docs": 732392,
"avbid": 5,
"isgeo": 0,
"isquest": 0,
"nw": 0,
"delta": 0,
"churl": 0,
"wizardscount": 0,
"wizards": {"43": "карта"
},
"kid": 572850182,
"did": 30069294,
"serpf": "10.06.2024"
}
]
}

Контекстная реклама

Контекстная реклама - конкуренты

Пример запроса https://api.keys.so/report/simple/context/concurents?base=msk&domain=wildberries.ru&sort=cnt%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 14791338,
"name": "wildberries.ru",
"perc": 28.1,
"theme": 34.7,
"cnt": 479138,
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529,
"pagesinindex": 117711,
"vis": 110373,
"adscnt": 16075,
"adkeyscnt": 732392,
"adtraf": 33507,
"adcost": 11109590
}
]
}

Контекстная реклама - ключевые слова по объявлению

Пример запроса https://api.keys.so/report/simple/context/keywords/byads?base=msk&domain=wildberries.ru&sort=pos%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
ads_id required	string Идентификатор объявления
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"word": "бенеттон официальный сайт",
"header": "",
"txt": "",
"ws": 14791338,
"wsk": 86990,
"pos": 0,
"sr": 0,
"numwords": 5,
"adscnt": 16075,
"docs": 732392,
"avbid": 5,
"isgeo": 0,
"isquest": 0
}
]
}

Контекстная реклама - ключевые слова

Пример запроса https://api.keys.so/report/simple/context/keywords?base=msk&domain=wildberries.ru&sort=pos%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 31497995,
"aid": 31497995,
"word": "бенеттон официальный сайт",
"header": "",
"txt": "",
"ws": 14791338,
"wsk": 86990,
"pos": 0,
"sr": 0,
"numwords": 5,
"adscnt": 16075,
"docs": 732392,
"avbid": 5,
"isgeo": 0,
"isquest": 0,
"url": "https://www.wildberries.ru/brands/tentov/okna?yclid=10018058859678269439",
"serpf": "10.06.2024"
}
]
}

Контекстная реклама - объявления

Пример запроса https://api.keys.so/report/simple/context/ads?base=msk&domain=wildberries.ru&sort=keyscnt%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
full	boolean Default: false Если `1`, в отчет будет добавлен массив ключевых слов по каждому объявлению
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 234121,
"header": "Пластиковые окна КАЛЕВА! – Скидка 23%! От производителя!",
"txt": "Окна от производителя. Индикатор погоды METEOGLASS в подарок! Замер 0 руб. Звоните!",
"links": ["string"
],
"facts": ["string"
],
"keyscnt": 1,
"keys": ["стоимость установки пластиковых окон в деревянном доме"
],
"url": "https://www.wildberries.ru/catalog/13866813/detail.aspx?utm_source=akiwayandex&utm_medium=cpc&utm_campaign=73048-id-aw_hzn_poisk_rf_wb&utm_term=gid_5428889999|ad_16022413716|pst_other|devt_mobile|rn_%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0|---autotargeting&yclid=7688559660684804095",
"legal": "ООО ЛЕОВИТ нутрио, ИНН 7713204095, ID 77154557"
}
]
}

Контекстная реклама - объявления, уникальные ссылки

Пример запроса https://api.keys.so/report/simple/context/ads/links?base=msk&domain=wildberries.ru&sort=cnt%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"links": ["string"
]
}
]
}

Контекстная реклама - объявления, уникальные факты

Пример запроса https://api.keys.so/report/simple/context/ads/facts?base=msk&domain=wildberries.ru&sort=cnt%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"facts": ["string"
]
}
]
}

Запросы

Запросы сервиса

Пример запроса https://api.keys.so/report/system_keywords?strict=true&base=msk&hideadult=true

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
strict required	boolean Default: true Нечеткий поиск(поддержка склонения слов, изменения их порядка, не более 1 000 000 результатов)
hideadult required	boolean Default: true Скрыть запросы тематики 18+
page	integer Default: 1 Порядковый номер страницы результатов
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`

Request Body schema: application/json

object

Параметры запроса в теле

Responses

Request samples

Payload

Content type

application/json

{"params": {"filter": "string",
"per_page": 25,
"page": 1,
"sort": "string"
}
}

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"adscnt": 16075,
"superwsk": 32765856,
"ws": 14791338,
"wsk": 86990,
"docs": 732392,
"numwords": 1,
"word": "ютуб",
"updated_at": "26.05.2024",
"isgeo": 0,
"isquest": 0,
"isadult": 0,
"gctr": 0,
"gamn": 0,
"avbid": 0
}
]
}

Дополняющие фразы

Пример запроса https://api.keys.so/report/simple/similarkeys?base=msk&keyword=%D0%BF%D0%BB%D0%B0%D1%81%D1%82%D0%B8%D0%BA%D0%BE%D0%B2%D1%8B%D0%B5%20%D0%BE%D0%BA%D0%BD%D0%B0 &sort=wsk%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
keyword required	string Поисковый запрос
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"word": "как сделать ремонт на балконе",
"cnt": 68,
"ws": 14791338,
"wsk": 86990,
"docs": 732392,
"avbid": 5,
"numwords": 5,
"adscnt": 16075,
"isgeo": 0,
"isquest": 0,
"wizardscount": 0,
"wizards": {"43": "карта"
},
"serpf": "10.06.2024",
"kei": 0
}
]
}

Чистка неявных дублей

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json
required

list

required

Array of arrays

Массив фраз для чистки дублей

Responses

Request samples

Payload

Content type

application/json

{"list": ["одежда для беременных",
"для беременных одежда",
"одежда"
]
}

Response samples

200

Content type

application/json

{"keys": [["одежда",
"одежда для беременных"
]
],
"exclude": [["для беременных одежда"
]
]
}

Расширение ключевых фраз - создание задания

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json
required

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
list required	Array of strings Массив фраз
	object Default: {"similarity":30,"deleteDuplicate":true,"additions":false} Массив фраз

Responses

Request samples

Payload

Content type

application/json

{"base": "msk",
"list": ["одежда для беременных",
"для беременных одежда",
"одежда"
],
"config": {"similarity": 30,
"deleteDuplicate": true,
"additions": false
}
}

Response samples

200

Content type

application/json

{"uid": "7d9a401359df946e37cbebfc937a5d65"
}

Расширение ключевых фраз - состояние отчета

Пример запроса https://api.keys.so/tools/extended_keywords/state/7d9a401359df946e37cbebfc937a5d65 полученный в Расширение ключевых фраз - создание задания

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчета

Responses

Response samples

200

Content type

application/json

{"state": 10,
"progress": 100
}

Расширение ключевых фраз - получение результата

Пример запроса https://api.keys.so/tools/extended_keywords/7d9a401359df946e37cbebfc937a5d65?sort=wsk%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчета

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"source_key": "pizza",
"destination_key": "a pizza near me",
"ws": 14791338,
"wsk": 86990,
"frequency": 0,
"numwords": 5,
"adscnt": 16075,
"docs": 732392,
"avbid": 5,
"isgeo": 0,
"isquest": 0,
"addition": false,
"cnt": 12,
"maxcpc": 12,
"mincpc": 12
}
]
}

Массовая проверка запросов - создание задания

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json
required

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

list

required

Array of arrays

Массив фраз

Responses

Request samples

Payload

Content type

application/json

{"base": "msk",
"list": ["одежда для беременных",
"для беременных одежда",
"одежда"
]
}

Response samples

200

Content type

application/json

{"uid": "6684baecf18566c4381fc7731925481"
}

Массовая проверка запросов - получение результата

Пример запроса https://api.keys.so/tools/keywords_by_list/msk:44:6684baecf18566c4381fc7731925481d?base=msk&sort=wsk%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчета

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"word": "pizza",
"ws": 14791338,
"wsk": 86990,
"numwords": 5,
"adscnt": 16075,
"docs": 732392,
"avbid": 5,
"isgeo": 0,
"isquest": 0,
"serpf": "24.09.2022"
}
]
}

История выдачи SERP по запросу

Пример запроса https://api.keys.so/tools/history-serp?base=gru

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

Request Body schema: application/json

keyword

required

string

Поисковая фраза

Responses

Request samples

Payload

Content type

application/json

{"keyword": "купить телефон"
}

Response samples

200

Content type

application/json

{"<YYYY.MM>": {"did": 261720522,
"domain": "notisend.ru",
"pos": 0,
"url": "/catalog/464638/detail.aspx"
}
}

Подсветка топов

Пример запроса https://api.keys.so/tools/check-top?base=msk

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

Request Body schema: application/json

list

required

Array of strings

Список поисковых фраз

Responses

Request samples

Payload

Content type

application/json

{"list": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
]
}

Response samples

200

Content type

application/json

{"<keyword>": [{"count": {"domain": 0,
"url": 0
},
"domain": "testometrika.com",
"pos": 1,
"url": "testometrika.com\\/tests"
}
]
}

Подсветка топов - сайты конкурентов

Пример запроса https://api.keys.so/tools/check-top-concurents-domains?base=msk

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

Request Body schema: application/json

list required	Array of strings Список поисковых фраз
page	integer Текущая страница
perPage	integer Записей на странице

Responses

Request samples

Payload

Content type

application/json

{"list": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
],
"page": 1,
"perPage": 25
}

Response samples

200

Content type

application/json

{"total": 150,
"data": [{"cnt": 5,
"did": 29918164,
"name": "yandex.ru"
}
]
}

Подсветка топов - страницы конкурентов

Пример запроса https://api.keys.so/tools/check-top-concurents-urls?base=msk

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

Request Body schema: application/json

list required	Array of strings Список поисковых фраз
page	integer Текущая страница
perPage	integer Записей на странице

Responses

Request samples

Payload

Content type

application/json

{"list": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
],
"page": 1,
"perPage": 25
}

Response samples

200

Content type

application/json

{"total": 150,
"data": [{"cnt": 5,
"did": 29918164,
"fullUrl": "pikabu.ru/story/6_poiskovikov_kotoryie_luchshe_chem_google_4228012",
"name": "yandex.ru",
"url": "/story/6_poiskovikov_kotoryie_luchshe_chem_google_4228012"
}
]
}

Сравнение списков ключевых фраз

Пример запроса https://api.keys.so/tools/compare

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

left required	Array of strings Список поисковых фраз
right required	Array of strings Список поисковых фраз
options required	string Enum: "present_right" "uniq" "union" "present_left" Тип сравнения

Responses

Request samples

Payload

Content type

application/json

{"left": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
],
"right": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
],
"options": "present_right"
}

Response samples

200

Content type

application/json

["заключение от фтизиатра",
"фтизиатр после пробы манту"
]

Комбинатор ключевых фраз

Пример запроса https://api.keys.so/tools/combine

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

lists required	Array of arrays Список поисковых фраз
options	Array of strings Дополнительные настройки: `Заключить в " "` - quotes `Заключить в «[ ]»` - brackets `Добавить комбинации без операторов` - simple `Добавить «+» к стоп-словам` - simple

Responses

Request samples

Payload

Content type

application/json

{"lists": {"0": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
],
"1": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
],
"2": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
]
},
"options": ["quotes",
"brackets",
"simple",
"stop_word"
]
}

Response samples

200

Content type

application/json

"string"

Выделение уникальных слов в тексте

Пример запроса https://api.keys.so/tools/unique

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

list

required

Array of strings

Список поисковых фраз

Responses

Request samples

Payload

Content type

application/json

{"list": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
]
}

Response samples

200

Content type

application/json

{"count": 18,
"open": false,
"keys": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
],
"words": ["фтизиатра",
"фтизиатру",
"фтизиатр"
]
}

Сбор поисковых подсказок в Яндексе

Пример запроса https://api.keys.so/tools/suggest

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

list

required

Array of strings

Список исходных ключевых слов

region

required

integer

Enum: 1 2 4 5 7 8 9 10 11 12 13 14 15 16 20 21 22 23 24 25 28 30 33 35 36 37 38 39 41 42 43 45 47 48 49 50 51 53 54 56 62 63 64 65 66 67 75 76 77 149 159 172 187 191 192 193 195 197 213 225 239 973 1092 1104 1106

Код региона:
1 - Москва и Московская область
2 - Санкт-Петербург
4 - Белгород
5 - Иваново
7 - Кострома
8 - Курск
9 - Липецк
10 - Орел
11 - Рязань
12 - Смоленск
13 - Тамбов
14 - Тверь
15 - Тула
16 - Ярославль
20 - Архангельск
21 - Вологда
22 - Калининград
23 - Мурманск
24 - Великий Новгород
25 - Псков
28 - Махачкала
30 - Нальчик
33 - Владикавказ
35 - Краснодар
36 - Ставрополь
37 - Астрахань
38 - Волгоград
39 - Ростов-на-Дону
41 - Йошкар-Ола
42 - Саранск
43 - Казань
45 - Чебоксары
47 - Нижний Новгород
48 - Оренбург
49 - Пенза
50 - Пермь
51 - Самара
53 - Курган
54 - Екатеринбург
56 - Челябинск
62 - Красноярск
63 - Иркутск
64 - Кемерово
65 - Новосибирск
66 - Омск
67 - Томск
75 - Владивосток
76 - Хабаровск
77 - Благовещенск
149 - Беларусь
159 - Казахстан
172 - Уфа
187 - Украина
191 - Брянск
192 - Владимир
193 - Воронеж
195 - Ульяновск
197 - Барнаул
213 - Москва
225 - Россия
239 - Сочи
973 - Сургут
1092 - Назрань
1104 - Черкесск
1106 - Грозный

Responses

Request samples

Payload

Content type

application/json

{"list": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
],
"region": 1
}

Response samples

200

Content type

application/json

{"link": "https://www.keys.so/public/download/csv663.2950/suggest.csv"
}

Ссылки

Входящие ссылки

Пример запроса https://api.keys.so/report/simple/links/backlinks?domain=wildberries.ru&sort=created_at%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"anchor": "ИЦК-121 Кроссовки мужские",
"created_at": "26.05.2024",
"domain_exist": true,
"id": 261720522,
"link_type": 1,
"rel_type": [1
],
"source_did": 302456420,
"source_dr": 0,
"source_ip": "198.54.121.233",
"source_name": "trmorning.com",
"source_title": "Portfolio Nine - My Portfolio Blog",
"source_url": "https://trmorning.com",
"url": "https://trmorning.com",
"status": 0,
"updated_at": "26.05.2024"
}
]
}

Исходящие ссылки

Пример запроса https://api.keys.so/report/simple/links/outlinks?domain=wildberries.ru&sort=created_at%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"anchor": "ИЦК-121 Кроссовки мужские",
"created_at": "26.05.2024",
"domain_exist": true,
"did": 261720522,
"id": 343254837,
"link_type": 1,
"rel_type": [1
],
"dr": 0,
"name": "trmorning.com",
"source_url": "https://trmorning.com",
"url": "https://trmorning.com",
"status": 0,
"updated_at": "26.05.2024"
}
]
}

Ссылающиеся домены

Пример запроса https://api.keys.so/report/simple/links/backlinks-domains?domain=wildberries.ru&sort=backlinks_count%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"did": 261720522,
"id": 343254837,
"rel_type": [1,
2,
0
],
"dr": 67,
"backlinks_count": 533737599,
"name": "trmorning.com",
"ips": 210301,
"total_backdomains_count": 1973265,
"total_outdomains_count": 472156,
"vis": 6111921
}
]
}

Исходящие домены

Пример запроса https://api.keys.so/report/simple/links/outlinks-domains?domain=wildberries.ru&sort=outlinks_count%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"did": 261720522,
"id": 343254837,
"rel_type": [1,
2,
0
],
"dr": 67,
"outlinks_count": 66518846,
"name": "trmorning.com",
"ips": 210301,
"total_backdomains_count": 1973265,
"total_outdomains_count": 472156,
"vis": 6111921,
"statuses": [1,
10
]
}
]
}

Ссылки по IP

Пример запроса https://api.keys.so/report/simple/links/backlinks-ip?domain=wildberries.ru&sort=backlinks_count%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"backlinks_count": 261720522,
"domains_count": 154,
"domains": ["msk.compumir.ru",
"965059"
],
"source_ip": "94.198.51.98"
}
]
}

Ссылки по IP - подсети

Пример запроса https://api.keys.so/report/simple/links/backlinks-ip/subnet?domain=wildberries.ru&sort=domains_count%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"backlinks_count": 261720522,
"domains_count": 154,
"ips_count": 60,
"subnet": "185.215.4.*"
}
]
}

Анкоры

Пример запроса https://api.keys.so/report/simple/links/backlinks-anchor?domain=wildberries.ru&sort=backlinks_count%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"anchor": "Подробнее...",
"backlinks_count": 343254837,
"rel_type": [1,
2,
0
],
"link_type": 1,
"words_count": 1,
"statuses": [1,
10
]
}
]
}

Кластеризатор

Кластеризация - создание задания

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

list

required

Array of strings

Массив фраз

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

Responses

Request samples

Payload

Content type

application/json

{"list": ["одежда для беременных",
"для беременных одежда",
"одежда"
],
"base": "msk"
}

Response samples

200

Content type

application/json

{"uid": "msk:44:6684baecf18566c4381fc7731925481"
}

Кластеризация - запуск процесса

Запуск процесса. Вместо UID в уре запроса, идентификатор полученный при создании.

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

Request Body schema: application/json
required

topNumber	integer Глубина проверки(топ 10, 20, 50)
fStrength	integer Более общее\мелкие группы(%)
fIsWsk	boolean Минимальная [!частотность] главного ключа в группе(использовать или нет)
fWsk	integer Минимальная [!частотность] главного ключа в группе(значение)
fIsSumWsk	boolean Минимальная суммарная [!частотность] группы(использовать или нет)
fSumWsk	boolean Минимальная суммарная [!частотность] группы(значение)

Responses

Request samples

Payload

Content type

application/json

{"topNumber": 10,
"fStrength": 50,
"fIsWsk": true,
"fWsk": 100,
"fIsSumWsk": true,
"fSumWsk": true
}

Response samples

200

Content type

application/json

true

Кластеризация - удаление проекта

Пример запроса https://api.keys.so/clustering/b8095aa8g82defb29f9a1660640fa7f9

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

Responses

Response samples

200

Content type

application/json

true

Список проектов кластеризатора

Пример запроса https://api.keys.so/clustering/list?sort=access_date%7Casc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"uid": "94e99ef90a8fa62000227d5bc122e5c42123",
"name": "asa1d",
"base": "msk",
"create_date": "2024-04-22 04:03:15",
"access_date": "2024-04-22 04:03:27",
"state": 10,
"owner": "[email protected]",
"canDelete": true,
"canChangeOwner": true
}
]
}

Кластеризация - запуск процесса

Запуск процесса. Вместо UID в уре запроса, идентификатор полученный при создании.

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

Request Body schema: application/json
required

topNumber	integer Глубина проверки(топ 10, 20, 50)
fStrength	integer Более общее\мелкие группы(%)
fIsWsk	boolean Минимальная [!частотность] главного ключа в группе(использовать или нет)
fWsk	integer Минимальная [!частотность] главного ключа в группе(значение)
fIsSumWsk	boolean Минимальная суммарная [!частотность] группы(использовать или нет)
fSumWsk	boolean Минимальная суммарная [!частотность] группы(значение)

Responses

Request samples

Payload

Content type

application/json

{"topNumber": 10,
"fStrength": 50,
"fIsWsk": true,
"fWsk": 100,
"fIsSumWsk": true,
"fSumWsk": true
}

Response samples

200

Content type

application/json

true

Статус обработки отчета

Пример запроса https://api.keys.so/clustering/state/0906fcc65ea67fcc8f090bd00ade39ada

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

Responses

Response samples

200

Content type

application/json

{"state": 10,
"progress": 100
}

Получение папок кластеризации

Пример запроса https://api.keys.so/clustering/node/59f2bо9004be5449891467f07a4eb5a9

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

Responses

Response samples

200

Content type

application/json

{"0": {"id": 0,
"pid": -10,
"name": "Все узлы",
"keys_count": 0,
"max_key_wsk": 0,
"max_key_ws": 0,
"ws_sum": 0,
"wsk_sum": 0,
"lock": false,
"children": [{"id": -1,
"pid": 0,
"name": "Нераспределенные",
"lock": true,
"keys_count": 90,
"ws_sum": 0,
"wsk_sum": 0,
"max_key_ws": 0,
"max_key_wsk": 0,
"children": [ ]
}
]
}
}

Результат кластеризации, ключи в папке

Пример запроса https://api.keys.so/clustering/node/59f2b99604be5449891467f07a4eb5a7/46984224/keywords?sort=wsk%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid required	string Идентификатор отчёта
id required	string Идентификатор папки

query Parameters

page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 1089273244,
"adscnt": 16075,
"isgeo": 0,
"isquest": 0,
"master_key": 1,
"numwords": 4,
"word": "создать игру на андроид",
"ws": 1479,
"wsk": 869
}
]
}

Мои проекты

Создание проекта

Пример запроса https://api.keys.so/projects

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

domain required	string Адрес сайта
name	string Название проекта
competitors	Array of strings Конкуренты

Responses

Request samples

Payload

Content type

application/json

{"domain": "notisend.ru",
"name": "notisend.ru",
"competitors": ["senler.ru",
"sigmasms.ru",
"smsdar.ru",
"smspobeda.ru",
"bandlink.media"
]
}

Response samples

200

Content type

application/json

[ ]

Список проектов

Пример запроса /projects

Authorizations:

X-Keyso-TOKENauth-token

Responses

Response samples

200

Content type

application/json

[{"projectId": 51565,
"title": "notisend.ru",
"domain": {"did": 30457180,
"name": "notisend.ru",
"main": true
},
"competitors": [{"did": 77679802,
"name": "senler.ru",
"main": false
}
],
"settings": {"chartSettings": {"vis": true,
"it50": true,
"it10": true,
"it3": true,
"pagesInIndex": true,
"adTraf": true,
"adKeysCount": true,
"adsCount": true,
"adCost": true,
"rsyAdsCount": true,
"backlinksCount": true,
"outlinksCount": true,
"uniqBackdomainsCount": true,
"uniqBackipsCount": true,
"dr": true
},
"notificationSettings": {"organic": true,
"context": false,
"links": true,
"databases": {"msk": true,
"gru": true
}
},
"isDemo": false
},
"extSettings": {"notifications": {"isNotifyMuted": false,
"periodicity": 1,
"notifyEmail": true,
"notifyTelegram": false
}
},
"imageUrl": "https://f004.backblazeb2.com/file/projects-icons/cd159ccaa30c4145989741d916f5684fe080abb6990d5afcc5f815c3da4274cd.png",
"periodicityData": {"1": "При изменении",
"2": "Раз в 14 дней",
"3": "Раз в месяц"
},
"hidden": false,
"exist": true,
"isFree": false,
"lastNotifyData": {"msk": [{"organic": {"vis": {"value": 18,
"delta": -1
},
"it50": {"value": 324,
"delta": 14
},
"it10": {"value": 45,
"delta": 2
},
"it3": {"value": 18,
"delta": -2
},
"pagesInIndex": {"value": 21,
"delta": 0
}
},
"context": {"adTraf": {"value": 1,
"delta": 0
},
"adKeysCount": {"value": 83,
"delta": 14
},
"adsCount": {"value": 18,
"delta": 3
},
"adCost": {"value": 6333,
"delta": -11867
},
"rsyAdsCount": {"value": 1,
"delta": -1
}
}
}
],
"gru": [{"organic": {"vis": {"value": 19,
"delta": -3
},
"it50": {"value": 530,
"delta": 0
},
"it10": {"value": 78,
"delta": -1
},
"it3": {"value": 28,
"delta": 0
},
"pagesInIndex": {"value": 46,
"delta": 1
}
},
"context": {"adTraf": {"value": 0,
"delta": 0
},
"adKeysCount": {"value": 0,
"delta": 0
},
"adsCount": {"value": 0,
"delta": 0
},
"adCost": {"value": 0,
"delta": 0
},
"rsyAdsCount": {"value": 0,
"delta": 0
}
}
}
],
"link": [{"drmsk": {"value": 20,
"delta": -2
},
"drgru": {"value": 20,
"delta": -4
},
"backlinksCount": {"value": 3278,
"delta": 135
},
"outlinksCount": {"value": 469,
"delta": 20
},
"uniqBackdomainsCount": {"value": 143,
"delta": 0
},
"uniqBackipsCount": {"value": 114,
"delta": 0
}
}
]
},
"type": 1,
"colors": {"vis": "#4DC9F6",
"it50": "#F67019",
"it10": "#DC2B2B",
"it3": "#B6E302",
"pagesInIndex": "#F53794",
"dr": "#537BC4",
"adTraf": "#ACC236",
"adKeysCount": "#00A950",
"adsCount": "#58595B",
"rsyAdsCount": "#8549BA",
"adCost": "cyan",
"backlinksCount": "red",
"outlinksCount": "violet",
"uniqBackdomainsCount": "lightcoral",
"uniqBackipsCount": "darkred"
},
"gData": {"<YYYY.MM>": {"vis": 1,
"it50": 352,
"it10": 7,
"it3": 1,
"pagesInIndex": 18,
"adTraf": 2,
"adKeysCount": 485,
"adsCount": 21,
"adCost": 796308,
"dr": 0,
"rsyAdsCount": 0,
"backlinksCount": 0,
"outlinksCount": 0,
"uniqBackdomainsCount": 0,
"uniqBackipsCount": 0
}
},
"data": [{"<index>": {"type": "organic",
"name": "vis",
"value": 18,
"delta": -1,
"link": "/ru/report?domain=notisend.ru"
}
}
],
"hideItems": [ ],
"position": 4
}
]

Удаление проекта

Пример запроса https://api.keys.so/projects/delete

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

projectId

required

integer

Идентификатор проекта

Responses

Request samples

Payload

Content type

application/json

{"projectId": 3134
}

Response samples

200

Content type

application/json

[ ]

Сравнение с конкурентами

Пример запроса https://api.keys.so/projects/competitors?projectId=12333

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

projectId

integer

Example: projectId=12333

Идентификатор проекта

Responses

Response samples

200

Content type

application/json

[{"<property>": {"checked": {"30457180": false,
"77679802": false
},
"colors": {"30457180": "#4DC9F6",
"77679802": "#F67019"
},
"domains": [{"did": 77679802,
"name": "senler.ru",
"main": false
}
],
"gData": {"<domainID>": {"2016.1": 40141,
"2016.12": 497,
"2017.01": 0
}
},
"links": {"<domainID>": {"30457180": "/ru/report?domain=notisend.ru"
}
},
"name": "adCost",
"showProperty": true,
"views": ["organic",
"context"
],
"xAxis": [2024.04,
2024.05,
2024.06
]
}
}
]

Сравнение с конкурентами(диаграмма)

Пример запроса https://api.keys.so/projects/competitors/compare

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

view required	string Enum: "organic" "context" Отчет вернет результаты для органики(`organic`) или контекста(`context`)
domains required	Array of strings Конкуренты
type	integer Deprecated

Responses

Request samples

Payload

Content type

application/json

{"view": "organic",
"domains": ["senler.ru",
"sigmasms.ru",
"smsdar.ru",
"smspobeda.ru",
"bandlink.media"
],
"type": 1
}

Response samples

200

Content type

application/json

{"domainData": [{"id": 1089273244,
"it1": 86,
"it5": 45527,
"it10": 742944,
"it50": 1683529,
"name": "lamoda.ru",
"adcost": 1110959,
"adkeyscnt": 73239,
"adscnt": 16075,
"adTraf": 75
}
],
"joins": [{"sets": [30457180,
277076264
],
"size": 183
}
]
}

Сайты

Доля конкурентов по поисковым фразам - создание отчета

Создание отчета и получение идентификатора, который понадобится в дальнейшем для взаимодействия с отчетом.

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

list

required

Array of strings

Список поисковых фраз

Responses

Request samples

Payload

Content type

application/json

{"base": "msk",
"list": ["справка от фтизиатра онлайн",
"заключение от фтизиатра",
"запись на прием к врачу"
]
}

Response samples

200

Content type

application/json

{"uid": "96716504gf5a491bffd731bb10bf7dc489"
}

Доля конкурентов по поисковым фраза - статус обработки отчета

Пример запроса https://api.keys.so/tools/concurents_by_keywords/state/0906fcc6567fcc8f090bd00ade39ada

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

Responses

Response samples

200

Content type

application/json

{"state": 10,
"progress": 100
}

Доля конкурентов по поисковым фразам - отчет

Пример запроса https://api.keys.so/tools/concurents_by_keywords/96716504gf5a491bffd731bb10bf7dc489?base=msk&view=organic&sort=it50%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

query Parameters

view	string Default: "organic" Enum: "organic" "context" Отчет вернет результаты для органики(`organic`) или контекста(`context`)
base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 1089273244,
"it1": 86,
"it3": 302770,
"it5": 45527,
"it10": 742944,
"it50": 1683529,
"name": "lamoda.ru",
"perc": 28.1,
"spec": 16,
"gar": 19,
"cnt": 1
}
]
}

Главные темы сайта

Пример запроса https://api.keys.so/tools/site-themes?base=msk&site=keys.so&minWs=0&maxWs=999999999&minPos=1&maxPos=50&qbyUrl=1&words=1&like=%D0%BA%D0%BE%D0%BD%D0%BA%D1%83%D1%80%D0%B5%D0%BD%D1%82%D1%8B&notLike=%D1%82%D0%B5%D0%BC%D0%B0&sort=wsk%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

site required	string Example: site=keys.so
minWs	integer Example: minWs=2 Частотность не менее
maxWs	integer Example: maxWs=3 Частотность не более
minWsk	integer Example: minWsk=3 [!Частотность] не менее
maxWsk	integer Example: maxWsk=4 [!Частотность] не более
minPos	integer Example: minPos=3 Позиция от
maxPos	integer Example: maxPos=9 Позиция до
qbyUrl	integer Example: qbyUrl=1 Запросов с одной страницы
words	string Example: words=keys.so Частотность не более
like	string Example: like=Конкуренты Похож
notLike	string Example: notLike=Позиции Не похож
base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"adscnt": 16075,
"avbid": 5,
"cnt": 479138,
"docs": 732392,
"isgeo": 0,
"isquest": 0,
"numwords": 5,
"serpf": "10.06.2024",
"superwsk": 32765856,
"ws": 14791338,
"wsk": 86990,
"url": "/catalog/464638/detail.aspx",
"word": "как сделать ремонт на балконе"
}
]
}

Список запросов страниц - создание отчета

Создание отчета и получение идентификатора, который понадобится в дальнейшем для взаимодействия с отчетом.

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

list

required

Array of strings

Список запросов страниц

Responses

Request samples

Payload

Content type

application/json

{"base": "msk",
"list": ["dodopizza.ru/VerkhnyayaPyshma/bonusactions",
"dodopizza.ru/moscow/product/pepperoni-tomat",
"dodopizza.ru/verkhnyayapyshma/verkhnyayapyshma"
]
}

Response samples

200

Content type

application/json

{"uid": "96716504gf5a491bffd731bb10bf7dc489"
}

Список запросов страниц - статус обработки отчета

Пример запроса https://api.keys.so/tools/keywords_by_pages/state/3701a9cfcb2f9f72259e8ee717056f

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

Responses

Response samples

200

Content type

application/json

{"state": 10,
"progress": 100
}

Список запросов страниц - отчет по весу

Пример запроса https://api.keys.so/tools/keywords_by_pages/weight/7faaefe0jkdaab0009h1226a5dc4de16?base=msk&sort=wsk%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"adscnt": 16075,
"avbid": 5,
"docs": 732392,
"isgeo": 0,
"isquest": 0,
"numwords": 5,
"serpf": "24.09.2022",
"superwsk": 32765856,
"ws": 14791338,
"wsk": 86990,
"weight": 4,
"word": "ecco remote отзывы"
}
]
}

Список запросов страниц - отчет по страницам

Пример запроса https://api.keys.so/tools/keywords_by_pages/pages/7faaefe0jkdaab0009h1226a5dc4de16?base=msk&sort=wsk%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"adscnt": 16075,
"avbid": 5,
"docs": 732392,
"isgeo": 0,
"isquest": 0,
"name": "wildberries.ru",
"numwords": 5,
"serpf": "24.09.2022",
"superwsk": 32765856,
"ws": 14791338,
"wsk": 86990,
"word": "ecco remote отзывы",
"url": "/catalog/464638/detail.aspx"
}
]
}

Расширение словаря по странице - создание отчета

Создание отчета и получение идентификатора, который понадобится в дальнейшем для взаимодействия с отчетом.

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
url required	string URL исходной страницы
required	object Настройки

Responses

Request samples

Payload

Content type

application/json

{"base": "msk",
"url": "dodopizza.ru/VerkhnyayaPyshma/bonusactions",
"config": {"list": ["фраза"
],
"more": true,
"pages": ["example.ru/top"
],
"useList": true,
"usePages": true
}
}

Response samples

200

Content type

application/json

{"uid": "96716504gf5a491bffd731bb10bf7dc489",
"base": "msk"
}

Расширение словаря по странице - статус обработки отчета

Пример запроса https://api.keys.so/tools/dictionary-ext-by-page/state/0906fcc65ea67fcc8f090bd00ade39ada

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

Responses

Response samples

200

Content type

application/json

{"state": 10,
"progress": 100
}

Расширение словаря по странице - отчет

Пример запроса https://api.keys.so/tools/dictionary-ext-by-page/f5ce44356458eef19f3a45c019a3267?base=msk

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

Responses

Response samples

200

Content type

application/json

{"list": ["фраза"
],
"more": true,
"pages": ["example.ru/top"
],
"url": "dodopizza.ru/VerkhnyayaPyshma/bonusactions",
"useList": true,
"usePages": true,
"state": 10,
"result": [{"exist": [{"count": 26,
"keys": ["фраза",
"фраза2"
],
"open": 0,
"sumSuperwsk": 26,
"sumWs": 26,
"sumWsk": 26,
"words": ["фраза",
"фраза2"
]
}
],
"keys": [{"superwsk": 2,
"wsk": 2,
"ws": 2,
"word": "фраза"
}
],
"list": ["фраза",
"фраза2"
],
"notExists": [{"count": 26,
"keys": ["фраза",
"фраза2"
],
"open": 0,
"sumSuperwsk": 26,
"sumWs": 26,
"sumWsk": 26,
"words": ["фраза",
"фраза2"
]
}
]
}
]
}

Словарь слов по страницам - создание отчета

Создание отчета и получение идентификатора, который понадобится в дальнейшем для взаимодействия с отчетом.

Authorizations:

X-Keyso-TOKENauth-token

Request Body schema: application/json

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
pages required	Array of arrays Список страниц
	object Настройки

Responses

Request samples

Payload

Content type

application/json

{"base": "msk",
"pages": ["dodopizza.ru/VerkhnyayaPyshma/bonusactions",
"dodopizza.ru/bonusactionsz"
],
"config": {"more": true
}
}

Response samples

200

Content type

application/json

{"uid": "96716504gf5a491bffd731bb10bf7dc489"
}

Словарь слов по страницам - статус обработки отчета

Пример запроса https://api.keys.so/tools/dictionary-by-pages/state/0906fcc6567fcc8f090bd00ade39ada

Authorizations:

X-Keyso-TOKENauth-token

path Parameters

uid

required

string

Идентификатор отчёта

Responses

Response samples

200

Content type

application/json

{"state": 10,
"progress": 100
}

Словарь слов по страницам - отчет

Пример запроса https://api.keys.so/tools/dictionary-by-pages/659cc524aba41a0252e0a27535f8a064?base=msk

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

Responses

Response samples

200

Content type

application/json

{"more": true,
"uid": "659cc524aba41a0252e0a27535f8a064",
"state": 10,
"pages": ["keys.so",
"text.ru/"
],
"result": [{"keys": [{"superwsk": 2,
"wsk": 2,
"ws": 2,
"word": "фраза"
}
],
"words": [{"count": 26,
"keys": ["фраза",
"фраза2"
],
"open": 0,
"sumSuperwsk": 26,
"sumWs": 26,
"sumWsk": 26,
"words": ["фраза",
"фраза2"
]
}
]
}
]
}

Пакетный анализ

Пример запроса https://api.keys.so/tools/domains-batch?base=msk

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

Request Body schema: application/json

required	object Данные для анализа
	object Параметры запроса в теле

Responses

Request samples

Payload

Content type

application/json

{"data": {"domains": ["senler.ru",
"sigmasms.ru",
"smsdar.ru",
"smspobeda.ru",
"bandlink.media"
]
},
"params": {"filter": "string",
"per_page": 25,
"page": 1,
"sort": "string"
}
}

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"messageCollapse": {"text": "<b>it4power.ru</b>",
"title": "В базе keys.so по текущему региону нет данных по некоторым доменам (1 из 8)."
},
"data": [{"id": 30457180,
"adcost": 11109590,
"adkeyscnt": 732392,
"adscnt": 16075,
"adskeys": 0,
"adtraf": 33507,
"it1": 869,
"it3": 277,
"it5": 455279,
"it10": 742944,
"it50": 1683,
"keyspage": 16,
"name": "wildberries.ru",
"pagesinindex": 1177,
"result": 0,
"topkeys": 99,
"topvis": 141,
"traf": 3,
"vis": 110373
}
]
}

Пакетный анализ по ссылкам

Пример запроса https://api.keys.so/report/simple/links/domains-batch?base=msk

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base

string (base)

Default: "msk"

Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny"

Региональная база данных, по которой происходит выборка
msk - Яндекс: Москва
gru - Google: Москва
zen - Дзен
gkv - Google: Киев
rnd - Яндекс: Ростов-на-Дону
ekb - Яндекс: Екатеринбург
ufa - Яндекс: Уфа
sar - Яндекс: Саратов
krr - Яндекс: Краснодар
prm - Яндекс: Пермь
sam - Яндекс: Самара
kry - Яндекс: Красноярск
oms - Яндекс: Омск
kzn - Яндекс: Казань
che - Яндекс: Челябинск
nsk - Яндекс: Новосибирск
nnv - Яндекс: Н. Новгород
vlg - Яндекс: Волгоград
vrn - Яндекс: Воронеж
spb - Яндекс: Санкт-Петербург
mns - Яндекс: Минск
tmn - Яндекс: Тюмень
gmns - Google: Минск
tom - Яндекс: Томск
gny - Google: New York

Request Body schema: application/json

required	object Данные для анализа
	object Параметры запроса в теле

Responses

Request samples

Payload

Content type

application/json

{"data": {"domains": ["senler.ru",
"sigmasms.ru",
"smsdar.ru",
"smspobeda.ru",
"bandlink.media"
]
},
"params": {"filter": "string",
"per_page": 25,
"page": 1,
"sort": "string"
}
}

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 30457180,
"it10": 742944,
"it50": 1683,
"name": "wildberries.ru",
"vis": 110373,
"numurl": 155,
"numlink": 1,
"numdomain": 1,
"dr": 0,
"ip": "81.19.74.1"
}
]
}

Сравнение сайтов в органическом поиске

Пример запроса https://api.keys.so/report/compare?base=msk&incl=keys.so,text.ru&excl=&view=organic&sort=numwords%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
view	string Default: "organic" Enum: "organic" "context" "backlinks" Тип отчета `organic`
incl required	string Default: false Список доменов через запятую
excl required	string Default: false Список доменов через запятую
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"last_page": 85,
"per_page": 25,
"total": 2124,
"data": [{"adscnt": 16075,
"avbid": 5,
"docs": 732392,
"isgeo": 0,
"isquest": 0,
"numwords": 5,
"serpf": "24.06.2024",
"superwsk": 32765856,
"word": "создать игру на андроид",
"ws": 31497995,
"wsk": 185018
}
]
}

Сравнение сайтов в контекстной рекламе

Пример запроса https://api.keys.so/report/compare?base=msk&incl=keys.so,text.ru&excl=&view=organic&sort=numwords%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
view	string Default: "organic" Enum: "organic" "context" "backlinks" Тип отчета `context`, для данного инструмента необходимо явно указывать данный тип отчета
incl required	string Default: false Список доменов через запятую
excl required	string Default: false Список доменов через запятую
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"last_page": 85,
"per_page": 25,
"total": 2124,
"data": [{"adscnt": 16075,
"avbid": 5,
"docs": 732392,
"isgeo": 0,
"isquest": 0,
"numwords": 5,
"serpf": "24.06.2024",
"superwsk": 32765856,
"word": "создать игру на андроид",
"ws": 31497995,
"wsk": 185018
}
]
}

Сравнение сайтов по ссылкам

Пример запроса https://api.keys.so/report/compare?base=msk&incl=keys.so,text.ru&excl=&view=backlinks&sort=numurl%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
view	string Default: "organic" Enum: "organic" "context" "backlinks" Тип отчета `backlinks`, для данного инструмента необходимо явно указывать данный тип отчета
incl required	string Default: false Список доменов через запятую
excl required	string Default: false Список доменов через запятую
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"numurl": 15542,
"vis": 110373,
"ip": "94.198.51.98",
"numlink": 1,
"it10": 742944,
"it50": 1683529,
"name": "wildberries.ru",
"dr": 67
}
]
}

Объявления Yandex.Direct по домену

Пример запроса https://api.keys.so/report/simple/direct/domain?base=msk&domain=wildberries.ru&sort=keys_count%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
domain required	string Имя домена
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"last_page": 85,
"per_page": 25,
"total": 2124,
"data": [{"description": "string",
"domain": "fabrikaokon.ru",
"keys_count": 63898,
"link": "fabrikaokon.ru",
"regions": "Россия (кроме: Дальний Восток)",
"title": "Онлайн-магазин одежды и товаров",
"updated_at": "26.05.2024",
"uuid": "6d92874cb389a50d8b70cca8cddb73beda4f7dc3a87c5d75801f55bedafa748d7ca5a0"
}
]
}

Объявления Yandex.Direct по запросу

Пример запроса https://api.keys.so/report/simple/direct/ads?base=msk&kid=17222067&sort=keys_count%7Cdesc&page=1&per_page=25

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

base	string (base) Default: "msk" Enum: "msk" "gru" "zen" "gkv" "rnd" "ekb" "ufa" "sar" "krr" "prm" "sam" "kry" "oms" "kzn" "che" "nsk" "nnv" "vlg" "vrn" "spb" "mns" "tmn" "gmns" "tom" "gny" Региональная база данных, по которой происходит выборка `msk` - Яндекс: Москва `gru` - Google: Москва `zen` - Дзен `gkv` - Google: Киев `rnd` - Яндекс: Ростов-на-Дону `ekb` - Яндекс: Екатеринбург `ufa` - Яндекс: Уфа `sar` - Яндекс: Саратов `krr` - Яндекс: Краснодар `prm` - Яндекс: Пермь `sam` - Яндекс: Самара `kry` - Яндекс: Красноярск `oms` - Яндекс: Омск `kzn` - Яндекс: Казань `che` - Яндекс: Челябинск `nsk` - Яндекс: Новосибирск `nnv` - Яндекс: Н. Новгород `vlg` - Яндекс: Волгоград `vrn` - Яндекс: Воронеж `spb` - Яндекс: Санкт-Петербург `mns` - Яндекс: Минск `tmn` - Яндекс: Тюмень `gmns` - Google: Минск `tom` - Яндекс: Томск `gny` - Google: New York
kid required	integer Идентификатор фразы
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"last_page": 85,
"per_page": 25,
"total": 2124,
"data": [{"description": "string",
"domain": "fabrikaokon.ru",
"keys_count": 63898,
"link": "fabrikaokon.ru",
"regions": "Россия (кроме: Дальний Восток)",
"title": "Онлайн-магазин одежды и товаров",
"updated_at": "26.05.2024",
"uuid": "6d92874cb389a50d8b70cca8cddb73beda4f7dc3a87c5d75801f55bedafa748d7ca5a0"
}
]
}

Объявления в РСЯ

Пример запроса https://api.keys.so/report/ads/rsya?sort=&page=1&per_page=25&groupingBy=erir&filter=titleLIKE%25D0%259A%25D1%2580%25D0%25BE%25D1%2581%25D0%25BE%25D0%25B2%25D0%25BA%25D0%25B8%255EORlegalLIKE%25D0%259A%25D1%2580%25D0%25BE%25D1%2581%25D0%25BE%25D0%25B2%25D0%25BA%25D0%25B8%255EORtarget_urlLIKE%25D0%259A%25D1%2580%25D0%25BE%25D1%2581%25D0%25BE%25D0%25B2%25D0%25BA%25D0%25B8

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

groupingBy	string Enum: "img_path" "inn" "domain" "erir" Группировка. Данный параметр работает только при наличии фильтра. `img_path` - по изображению `inn` - по рекламодателю(ИНН) `domain` - по домену `erir` - по ЕРИР
page	integer Default: 1 Порядковый номер страницы результатов
per_page	integer Default: 25 Количество результатов на одной странице
sort	string Сортировка данных по полям. Формат: `field\|direction`, где `field` - имя колонки `direction` - направление сортировки, asc - по возрастанию, desc - по убыванию Например: `pos\|asc`, либо по двум полям `pos\|asc,wsk\|desc`
filter	string Подробнее про фильтрацию смотрите в разделе `Фильтрация данных`

Responses

Response samples

200

Content type

application/json

{"current_page": 1,
"last_page": 85,
"per_page": 25,
"total": 2124,
"message": "Информационное сообщение к отчету",
"data": [{"id": "1833034871623477182",
"title": "Hyundai Solaris 2016",
"company_name": "",
"second_title": "",
"body": "Седан. 2016. 1.6 Механика Бензин (123 л.с.). Узнать подробнее!",
"target_url": "https://avto-nomia-expert.ru/cars/hyundai/solaris/sedan-2016-16mexanika-123hp-sinii-4533001/?utm_campaign&utm_content=/cars/hyundai/solaris/sedan-2016-16mexanika-123hp-sinii-4533001/&utm_term=486000&utm_source=yandex&utm_medium=%D0%A1%D0%91%2F%D0%9A%D0%9A%2F10&yclid=1620301485320437759",
"files": ["e19052b0a6d345e599b786eba834e00806320574f6e077ea2718e15ac58376bca01783742bfb215e7df8676625a650e41f3e86252bc3a671c4a9c123b38b8818.webp"
],
"domain": "avto-nomia-expert.ru",
"view_cnt": 7,
"type": "Директ",
"size": "Адаптив",
"diff_days": "18",
"found_at": "08.06.24 16:33",
"updated_at": "26.06.24 17:00",
"region_name": "Красноярск",
"legal": "ООО ЮРАЛ ТРЭЙД, ИНН 6685129317, Рекламодатель ЕРИР #100479617",
"hash": 133776045420048200,
"group": [{ }
]
}
]
}

Keys.so API (1.0)

Описание

Авторизация

Стандартные параметры запроса

Фильтрация данных

Дашборд

Информация о домене (Дашборд)

Authorizations:

query Parameters

Responses

Response samples

Информация о ключевом слове (Дашборд)

Authorizations:

query Parameters

Responses

Response samples

Групповые отчеты

Список групповых отчетов

Authorizations:

query Parameters

Responses

Response samples

Создание отчета

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Статус обработки отчета

Authorizations:

Responses

Response samples

Домены в отчете

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Органическая выдача - ключевые слова группы

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Органическая выдача - конкуренты группы

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Органическая выдача - страницы группы

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Контекстная реклама - ключевые слова группы

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Контекстная реклама - конкуренты группы

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Контекстная реклама - объявления группы

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Контекстная реклама - объявления, уникальные ссылки группы

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Request Body schema: application/json
required