Документация на метод "fastaudit"
API для инструмента «Быстрый аудит сайта»:
URL: https://tools.pixelplus.ru/api/fastaudit
Для создания задачи необходимо сформировать POST-запрос и отправить его на URL метода с обязательными GET-параметром key и POST-параметрами описанными ниже. Система поставит задачу в очередь выполнения и вернет идентификатор отчета: report_id. Для получения результата проверки позиций необходимо отправить GET запрос с параметрами key и report_id.
Принимает параметры:
GET:
- key — ключ доступа к API (обязательный);
- report_id — Идентификатор отчета;
POST:
- url— урл (обязательный);
- lr — регион по Яндексу (обязательный);
- advanced - Аудит и позиции сайта;
Пример запроса:
{
"url": "pixelplus.ru",
"lr": "213",
"advanced": {
"req_array": [
"seo",
"продвижение",
"пиксель",
],
"subdomains": "on"
}
}
Возвращает JSON с массивом:
В случае успеха:
{
"response": {
"server_response": "200", //Код ответа сервера
"main_mirror": "https://pixelplus.ru/", //Главное зеркало
"robots_test": "Ok",
"title_test": "ok",
"title": "Создание и продвижение сайтов в Москве и Санкт-Петербурге, цены на разработку, поддержку и раскрутку сайтов (SEO) — веб-студия Пиксель Плюс",
"description": "Интернет-агентство Пиксель Плюс — изготовление сайтов под ключ, поддержка и поисковое продвижение в Яндексе и Google. Портфолио работ, цены на услуги. Контакты, онлайн-заявка.",
"h1_count": 1, // Кол-во тегов h1
"h1s": [ //Содержимое тегов h1
"Создание сайтов, их продвижение и поддержка"
],
"text_symb_count": 10133, //Объем текста
"double_title_urls": null, //Наличие дублей Title в индексе
"counters_test": { //Наличие счетчиков
"li_stat": false, //LiveInternet
"ym_stat": true, //Яндекс.Метрика
"ga_stat": true //Google Analytics
},
"paid_till_test": 396, //Дней до окончания домена
"index_test": "1853", //Страниц в индексе Яндекса без поддоменов
"index_test_site": "113907", //Страниц в индексе Яндеса с учетом поддоменов
"data_test": "7 лет 3 месяца 28 дней", //Возраст
"test_404": "ok", //Наличие 404
"encode": "windows-1251", //Кодировка
"tcy": "0", //ТИЦ
"yaca": false, //Наличие в YACA
"yaca_cat": false, //Категория в YACA
"iks": "950", //ИКС
"indexed_domains": { // Поддомены проекта
"domain": "pixelplus.ru",
"domains": {
"0": "https://pixelplus.ru",
"1": "https://tools.pixelplus.ru",
"2": "http://brand.pixelplus.ru",
"3": "http://print.pixelplus.ru",
"4": "http://promo.pixelplus.ru",
"5": "https://kazan.pixelplus.ru",
"6": "https://nsk.pixelplus.ru",
"7": "https://omsk.pixelplus.ru",
"8": "https://samara.pixelplus.ru",
"9": "https://spb.pixelplus.ru",
"10": "https://ufa.pixelplus.ru",
"11": "https://volgograd.pixelplus.ru",
"12": "http://api.tools.pixelplus.ru",
"13": "http://as.tools-test.pixelplus.ru",
"14": "http://dev.pixelplus.ru",
"15": "http://dg.tools-test.pixelplus.ru",
"16": "http://mail.pixelplus.ru",
"17": "https://idea.tools.pixelplus.ru",
"18": "https://career.pixelplus.ru",
"19": "https://chelyabinsk.pixelplus.ru",
"20": "https://context.pixelplus.ru",
"21": "https://ekb.pixelplus.ru",
"22": "https://en.pixelplus.ru",
"23": "https://krasnoyarsk.pixelplus.ru",
"24": "https://nn.pixelplus.ru",
"25": "https://partizan.pixelplus.ru",
"26": "https://perm.pixelplus.ru",
"27": "https://petrozavodsk.pixelplus.ru",
"28": "https://rostov.pixelplus.ru",
"29": "https://sochi.pixelplus.ru",
"30": "http://support.pixelplus.ru"
},
"count": 31 //Кол-во поддоменов
},
"domain_ip": "93.188.42.188", //IP
"google_index": "NotIndex", //Страниц в индесе Google с учетом поддоменов
"google_index_inurl": "NotIndex", //Страниц в индесе Google без учета поддомено
"link_pad": "1515", //Внешних ссылок на домен
"fast_check": { //Резльтаты инструмента "Быстрый чек позиций в Яндексе"
"top5": 2,
"top10": 2,
"top20": 2,
"top50": 2,
"queries": {
"seo": {
"relevant_URL": "pixelplus.ru/samostoyatelno/chto-takoe-seo/",
"full_relevant_URL": "pixelplus.ru/samostoyatelno/chto-takoe-seo/",
"position": 2,
"name": "seo",
"platform": "desktop"
},
"продвижение": {
"relevant_URL": "pixelplus.ru/poiskovoe_prodvizhenie_sajtov/",
"full_relevant_URL": "pixelplus.ru/poiskovoe_prodvizhenie_sajtov/",
"position": 3,
"name": "продвижение",
"platform": "desktop"
},
"пиксель": {
"relevant_URL": "pixelplus.ru/",
"full_relevant_URL": "pixelplus.ru/",
"domain": "pixelplus.ru",
"position": "1000",
"platform": "desktop",
"name": "пиксель"
}
},
"queries_count": 3,
"subdomains": "on"
}
}
}
В случае неудачи:
- {"error":"In progress","code":50} — задание с таким идентификатором еще не выполнено;
- {"error":"To much requests","code":"-67"} — задано слишком много запросов;
- {"error":"Not enough daily limits","code":-68} — недостаточно дневных лимитов;
- {"error":"Not enough hourly limits","code":-80} — недостаточно часовых лимитов;
- {"error":"Not enough weekly limits","code":-81} — недостаточно недельных лимитов;
- {"error":"Not enough monthly limits","code":-82} — недостаточно месячных лимитов;
- {"error":"Not enough yearly limits","code":-83} — недостаточно годовых лимитов;
- {"error":"access denided","code":-1} — если не задан ключ доступа;
- {"error":"access denided","code":-2} — если неверно задан ключ доступа;
- {"error":"unknown method","code":-3} — если неверно задано название метода;
- {"error":"Processing error","code":-104} — инструмент завершился с фатальной ошибкой;
- {"error":"Limits run out","code":-105} — во время выполнения инструмента закончились лимиты;
- {"error":"The process was canceled by a user","code":-106} — задача отменена пользователем;
- {"error":"The process took more than 6 hours and was canceled","code":-107} — инструмент очень долго работал в фоне и мы автоматически завершили процесс;
- {"error":"Processing error":-125} — непредвиденная ошибка;
Пример получения данных с данного API:
{
"response": {
"server_response": "200",
"main_mirror": "https://pixelplus.ru/",
"robots_test": "Ok",
"title_test": "ok",
"title": "Создание и продвижение сайтов в Москве и Санкт-Петербурге, цены на разработку, поддержку и раскрутку сайтов (SEO) — веб-студия Пиксель Плюс",
"description": "Интернет-агентство Пиксель Плюс — изготовление сайтов под ключ, поддержка и поисковое продвижение в Яндексе и Google. Портфолио работ, цены на услуги. Контакты, онлайн-заявка.",
"h1_count": 1,
"h1s": [
"Создание сайтов, их продвижение и поддержка"
],
"text_symb_count": 10133,
"text_word_count": 1306,
"double_title_urls": null,
"counters_test": {
"li_stat": false,
"ym_stat": true,
"ga_stat": true
},
"paid_till_test": 396,
"index_test": "1853",
"index_test_site": "113907",
"data_test": "7 лет 3 месяца 28 дней",
"test_404": "ok",
"encode": "windows-1251",
"tcy": "0",
"rang": "0",
"yaca": false,
"yaca_cat": false,
"iks": "950",
"indexed_domains": {
"domain": "pixelplus.ru",
"domains": {
"0": "https://pixelplus.ru",
"1": "https://tools.pixelplus.ru",
"2": "http://brand.pixelplus.ru",
"3": "http://print.pixelplus.ru",
"4": "http://promo.pixelplus.ru",
"5": "https://kazan.pixelplus.ru",
"6": "https://nsk.pixelplus.ru",
"7": "https://omsk.pixelplus.ru",
"8": "https://samara.pixelplus.ru",
"9": "https://spb.pixelplus.ru",
"10": "https://ufa.pixelplus.ru",
"11": "https://volgograd.pixelplus.ru",
"12": "http://api.tools.pixelplus.ru",
"13": "http://as.tools-test.pixelplus.ru",
"14": "http://dev.pixelplus.ru",
"15": "http://dg.tools-test.pixelplus.ru",
"16": "http://mail.pixelplus.ru",
"17": "https://idea.tools.pixelplus.ru",
"18": "https://career.pixelplus.ru",
"19": "https://chelyabinsk.pixelplus.ru",
"20": "https://context.pixelplus.ru",
"21": "https://ekb.pixelplus.ru",
"22": "https://en.pixelplus.ru",
"23": "https://krasnoyarsk.pixelplus.ru",
"24": "https://nn.pixelplus.ru",
"25": "https://partizan.pixelplus.ru",
"26": "https://perm.pixelplus.ru",
"27": "https://petrozavodsk.pixelplus.ru",
"28": "https://rostov.pixelplus.ru",
"29": "https://sochi.pixelplus.ru",
"30": "http://support.pixelplus.ru"
},
"count": 31
},
"domain_ip": "93.188.42.188",
"google_index": "NotIndex",
"google_index_inurl": "NotIndex",
"dmoz_found": false,
"link_pad": "1515",
"fast_check": {
"top5": 2,
"top10": 2,
"top20": 2,
"top50": 2,
"queries": {
"seo": {
"relevant_URL": "pixelplus.ru/samostoyatelno/chto-takoe-seo/",
"full_relevant_URL": "pixelplus.ru/samostoyatelno/chto-takoe-seo/",
"position": 2,
"name": "seo",
"platform": "desktop"
},
"продвижение": {
"relevant_URL": "pixelplus.ru/poiskovoe_prodvizhenie_sajtov/",
"full_relevant_URL": "pixelplus.ru/poiskovoe_prodvizhenie_sajtov/",
"position": 3,
"name": "продвижение",
"platform": "desktop"
},
"пиксель": {
"relevant_URL": "pixelplus.ru/",
"full_relevant_URL": "pixelplus.ru/",
"domain": "pixelplus.ru",
"position": "1000",
"platform": "desktop",
"name": "пиксель"
}
},
"queries_count": 3,
"subdomains": "on"
}
}
}