Поиск

Документация на метод "fastaudit"

API для инструмента «Быстрый аудит сайта»:
URL: https://tools.pixelplus.ru/api/fastaudit

Для создания задачи необходимо сформировать POST-запрос и отправить его на URL метода с обязательными GET-параметром key и POST-параметрами описанными ниже. Система поставит задачу в очередь выполнения и вернет идентификатор отчета: report_id. Для получения результата проверки позиций необходимо отправить GET запрос с параметрами key и report_id.


Принимает параметры:
GET:

  1. key — ключ доступа к API (обязательный);
  2. report_id — Идентификатор отчета;

POST:

  1. url— урл (обязательный);
  2. lr — регион по Яндексу (обязательный);
  3. 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"
    }
  }
}

В случае неудачи: 

  1. {"error":"In progress","code":50} — задание с таким идентификатором еще не выполнено;
  2. {"error":"To much requests","code":"-67"} — задано слишком много запросов; 
  3. {"error":"Not enough daily limits","code":-68} — недостаточно дневных лимитов;
  4. {"error":"Not enough hourly limits","code":-80} — недостаточно часовых лимитов;
  5. {"error":"Not enough weekly limits","code":-81} — недостаточно недельных лимитов;
  6. {"error":"Not enough monthly limits","code":-82} — недостаточно месячных лимитов;
  7. {"error":"Not enough yearly limits","code":-83} — недостаточно годовых лимитов;
  8. {"error":"access denided","code":-1} — если не задан ключ доступа;
  9. {"error":"access denided","code":-2} — если неверно задан ключ доступа;
  10. {"error":"unknown method","code":-3} — если неверно задано название метода;
  11. {"error":"Processing error","code":-104} — инструмент завершился с фатальной ошибкой;
  12. {"error":"Limits run out","code":-105} — во время выполнения инструмента закончились лимиты;
  13. {"error":"The process was canceled by a user","code":-106} — задача отменена пользователем;
  14. {"error":"The process took more than 6 hours and was canceled","code":-107} — инструмент очень долго работал в фоне и мы автоматически завершили процесс;
  15. {"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"
    }
  }
}