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/domains/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 Подробнее про фильтрацию смотрите в разделе Фильтрация данных
url	string Example: url=/ URL
includeSubLevels	integer Example: includeSubLevels=1 Включить подуровни

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/organic/sitepages/withkeys?base=msk&domain=dodopizza.ru&sort=url%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,
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529,
"vis": 110373,
"superwsk": 32765856
}
]
}

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

Пример запроса https://api.keys.so/report/simple/organic/lost_keywords?base=msk&domain=dodopizza.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,
"superwsk": 32765856,
"kid": 572850182,
"did": 261720522,
"serpf": "10.06.2024"
}
]
}

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

Пример запроса https://api.keys.so/report/simple/organic/lost_pages?base=msk&domain=dodopizza.ru&sort=it50%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,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"url": "/catalog/464638/detail.aspx",
"it1": 86990,
"it3": 302770,
"it5": 455279,
"it10": 742944,
"it50": 1683529,
"vis": 110373,
"drop_date": "01.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=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": [{"id": 343254837,
"rel_type": [1,
2,
0
],
"dr": 67,
"outlinks_count": 533737599,
"outlinks_active_count": 300000000,
"outlinks_archive_count": 233737599,
"name": "trmorning.com",
"ips": 210301,
"total_backdomains_count": 1973265,
"total_outdomains_count": 472156,
"vis": 6111921
}
]
}

Ссылающиеся домены c данными по конкретному домену

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

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

view required	string Example: view=domain Фильтр данных по конкретному домену
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

{"view": "domain",
"current_page": 1,
"per_page": 25,
"last_page": 85,
"total": 2124,
"data": [{"id": 343254837,
"rel_type": [1,
2,
0
],
"dr": 67,
"outlinks_count": 533737599,
"outlinks_active_count": 300000000,
"outlinks_archive_count": 233737599,
"name": "trmorning.com",
"vis": 6111921
}
]
}

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

Пример запроса https://api.keys.so/report/simple/links/outlinks-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": 66518846,
"backlinks_active_count": 20000000,
"backlinks_archive_count": 46518846,
"name": "trmorning.com",
"ips": 210301,
"total_backdomains_count": 1973265,
"total_outdomains_count": 472156,
"vis": 6111921,
"statuses": [1,
10
]
}
]
}

Исходящие домены c данными по конкретному домену

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

Authorizations:

X-Keyso-TOKENauth-token

query Parameters

view required	string Example: view=domain Фильтр данных по конкретному домену
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

{"view": "domain",
"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": 66518846,
"backlinks_active_count": 20000000,
"backlinks_archive_count": 46518846,
"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": [

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