API для разработчиков

Проверка статуса

GET /status/

Получение результата

GET /results/

Пример запроса для получения результатов из вкладки динамика позиций

https://app.rush-analytics.ru/apiv2/result/ranktracker/dynamic/24ХХ3/1?periodStart=2021-09-13&periodEnd=2021-11-28&apikey=acc998e8...ХХХ

Пример ответа

[{
  "keywords": [
    {
      "keyword": "системы lms",
      "wordstat": 521,
      "wordstat ''": 113,
      "wordstat '!'": 53,
      "group": "lms системы",
      "targeturl": "https://www.unicraft.org/blog/5613/sistema-upravleniya-obucheniem-lms/",
      "relevanturl": "https://www.unicraft.org/blog/5613/sistema-upravleniya-obucheniem-lms/",
      "positions": [
        {
          "date": "08.12.2021",
          "position": "16"
        },
        {
          "date": "14.12.2021",
          "position": "24",
          "diff": -8
        }

]

Пример запроса для получения результатов из вкладки видимость

https://app.rush-analytics.ru/apiv2/result/ranktracker/visibility/2ХХХ3/1?periodStart=2021-09-13&periodEnd=2021-11-28&apikey=acc998...ХХХ

Пример ответа

{
  "visibility": [
    {
      "traffic": 1358,
      "group": "Суммарная видимость",
      "visibilities": [
        {
          "date": "14.09.2021",
          "visibility": 57.1
        },
        {
          "date": "27.11.2021",
          "visibility": 48.27,
          "diff": -8.83
        }
      ]
    },
    {
      "traffic": 357,
      "group": "group1",
      "visibilities": [
        {
          "date": "14.09.2021",
          "visibility": 60.33
        },
        {
          "date": "27.11.2021",
          "visibility": 51.66,
          "diff": -8.67
        }
      ]
    },
       {
      "traffic": 0,
      "group": "group2",
      "visibilities": [
        {
          "date": "14.09.2021",
          "visibility": 85
        },
        {
          "date": "27.11.2021",
          "visibility": 10,
          "diff": -75
        }
      ]
    }
  ]
}

Пример запроса для получения списка конкурентов (необходимо для получения позиций по конкурентам)

https://app.rush-analytics.ru/apiv2/result/ranktracker/competitors/22ХХХ/1?apikey=acc998e8...ХХХ

Пример ответа

["assistentus.ru",
  "planfact.io",
  "ru.wikipedia.org",
  "netology.ru",
  "kom-dir.ru",
  "vc.ru",
  "gd.ru",
  "hh.ru",
  "hr-director.ru",
  "timeweb.com"
]

Пример запроса для получения списка регионов проекта

https://app.rush-analytics.ru/apiv2/result/ranktracker/regions/23ХХХ/1?apikey=acc998...ХХХ

Пример ответа

[
{
  "searchEngine": [
    {
      "id": 33091,
      "name": "Яндекс.ru - Москва(213)",
      "device": "desktop"
    },
    {
      "id": 33094,
      "name": "Google.ae - Дубай (Город)",
      "device": "mobile"
    }
  ]
}
]

Пример запроса для получения истории позиций

https://app.rush-analytics.ru/apiv2/result/ranktracker/positions_history/24ХХХ/1?periodStart=2021-11-13&periodEnd=2021-11-28&apikey=acc998e...ХХХ

Пример ответа

[
{
    "keyword": "системы lms",
    "positions_history": [
      {
        "date": "14.12.2021",
        "position": "24 (-8)"
      },
      {
        "date": "08.12.2021",
        "position": "16"
      }

]

Пример запроса для получения истории URL

https://app.rush-analytics.ru/apiv2/result/ranktracker/urls_history/24XXX/1?periodStart=2021-11-13&periodEnd=2021-11-28&apikey=acc998e...XXX

Пример ответа

[
{
    "keyword": "системы lms",
    "target_url": "/blog/5613/sistema-upravleniya-obucheniem-lms/",
    "urls_history": [
      {
        "date": "14.12.2021",
        "url": "https://www.unicraft.org/blog/5613/sistema-upravleniya-obucheniem-lms/"
      },
      {
        "date": "08.12.2021",
        "url": "https://www.unicraft.org/blog/5613/sistema-upravleniya-obucheniem-lms/"
      }
]

Пример запроса для получения истории сниппетов

https://app.rush-analytics.ru/apiv2/result/ranktracker/snippets_history/24XXX/1?periodStart=2021-11-13&periodEnd=2021-11-28&apikey=acc998e...XXX

Пример ответа

[
{
    "keyword": "системы lms",
    "position": "24",
    "snippets_history": [
      {
        "date": "14.12.2021",
        "snippet": "LMS системы для бизнеса: ключевые принципы работы<br />LMS (Learning Management System) — система управления обучением"
      },
      {
        "date": "08.12.2021",
        "snippet": "LMS системы для бизнеса: ключевые принципы работы<br />LMS (Learning Management System) — Она позволяет разрабатывать учебные материалы и предоставлять к ним совместный доступ в режиме реального времени."
      }

]

Пример запроса для получения видимости по конкурентам

https://app.rush-analytics.ru/apiv2/result/ranktracker/competitors_visibility/244XXX/1?periodStart=2021-09-13&periodEnd=2021-11-28&apikey=acc998...XXX

Пример ответа

[
{
    "competitor": "unicraft.org",
    "visibilities": [
      {
        "date": "08.12.2021",
        "visibility": "9.27%"
      },
      {
        "date": "14.12.2021",
        "visibility": "7.85% (-1.42%)"
      }
    ]
  },
  {
    "competitor": "planfact.io",
    "visibilities": [
      {
        "date": "08.12.2021",
        "visibility": "31.04%"
      },
      {
        "date": "14.12.2021",
        "visibility": "29.29% (-1.75%)"
      }


]

Пример запроса для получения лидеров тематики

https://app.rush-analytics.ru/apiv2/result/ranktracker/competitors_leaders/24ХХХ/1?periodStart=2021-09-13&periodEnd=2021-11-28&apikey=acc998...ХХХ

Пример ответа

[
{
    "competitor": "unicraft.org",
    "top10_info": [
      {
        "date": "14.12.2021",
        "top10_keywords": 14
      }
    ]
  },
  {
    "competitor": "planfact.io",
    "top10_info": [
      {
        "date": "14.12.2021",
        "top10_keywords": 52
      }
    ]
  },
  {
    "competitor": "netology.ru",
    "top10_info": [
      {
        "date": "14.12.2021",
        "top10_keywords": 51
      }

]

Пример запроса для получения позиций конкурентов

https://app.rush-analytics.ru/apiv2/result/ranktracker/competitors_positions/24ХХХ/1?periodStart=2021-09-13&periodEnd=2021-11-28&competitor=mossite24.ru&apikey=acc998e...ХХХ

Пример ответа

[
{
    "keyword": "системы lms",
    "wordstat": 521,
    "group": "lms системы",
    "positions": [
      {
        "date": "08.12.2021",
        "position": "> 100"
      },
      {
        "date": "14.12.2021",
        "position": "> 100"
      }
    ]
  },
  {
    "keyword": "lms система",
    "wordstat": 521,
    "group": "lms системы",
    "positions": [
      {
        "date": "08.12.2021",
        "position": "> 100"
      },
      {
        "date": "14.12.2021",
        "position": "> 100"
      }
]

Пример запроса для получения сравнения позиций по регионам

https://app.rush-analytics.ru/apiv2/result/ranktracker/compare_regions/24XXX/1?periodStart=2021-09-13&periodEnd=2021-11-28&apikey=acc998...XXX

Пример ответа

[
"keyword": "купить компьютер в москве",
    "regions_positions": [
      {
        "region": "Яндекс.ru - Москва(213)",
        "device": "desktop",
        "lang": "RU",
        "id": 328368,
        "date": "14.12.2021",
        "position": "1"
      },
      {
        "region": "Google.ru - Москва (Город)",
        "device": "desktop",
        "lang": "RU",
        "id": 328369,
        "date": "14.12.2021",
        "position": "4"
      },
      {
        "region": "Яндекс.ru - Волгоград(38)",
        "device": "desktop",
        "lang": "RU",
        "id": 328984,
        "date": "14.12.2021",
        "position": "1"
      },
      {
        "region": "Яндекс.ru - Саратов(194)",
        "device": "desktop",
        "lang": "RU",
        "id": 328985,
        "date": "14.12.2021",
        "position": "3"
      },
      {
        "region": "Яндекс.ru - Сибирь(59)",
        "device": "desktop",
        "lang": "RU",
        "id": 328986,
        "date": "14.12.2021",
        "position": "1"
      },
      {
        "region": "Яндекс.ru - Таиланд(995)",
        "device": "desktop",
        "lang": "RU",
        "id": 328987,
        "date": "14.12.2021",
        "position": "1"
      },
      {
        "region": "Яндекс.ru - Туапсе(1058)",
        "device": "desktop",
        "lang": "RU",
        "id": 328988,
        "date": "14.12.2021",
        "position": "3"
      }

]

Разовая проверка позиций

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

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

Получение результата

Проверка статуса

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

{
"apikey": "acc99ХХХ…dcef",
"name": "название проекта",
"url": "rush-analytics.ru",
"yandexRegions": [
{
"type": ".ru",
"id": 213,
"lang": "ru",
"device": 0
}
],
"googleRegions": [
{
"type": ".ru",
"id": 1011969,
"lang": "ru",
"device": 0
}
],
"keywords": [
"семантическое ядро"
]
}

Пример ответа

[
{
"regionid": "213",
"searchEngine": "Yandex",
"device": "0",
"keywords": [
{
"keyword": "семантическое ядро",
"position": "19",
"url": "https://www.rush-analytics.ru/blog/polnyy-gayd-po-semanticheskomu-yadru-ot-sbora-klyuchevyh-slov-do-klasterizacii"
}
],
"leadersOfTheme": [
{
"domain": "ru.wikipedia.org",
"visibility": 1
},
{
"domain": "TexTerra.ru",
"visibility": 1
},
}
]
},
{
"regionid": "1011969",
"searchEngine": "Google",
"device": "0",
"keywords": [
{
"keyword": "семантическое ядро",
"position": "10",
"url": "https://www.rush-analytics.ru/"
}
],
"leadersOfTheme": [
{
"domain": "ru.wikipedia.org",
"visibility": 1
},
{
"domain": "texterra.ru",
"visibility": 1
},
{
"domain": "netpeak.net",
"visibility": 1
}
]
}
]

Сбор ТОП 10 URL

Этот метод позволяет получить ТОП 10-100 URL по ключевым словам, а также URL лидеров тематики.

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

Проверка статуса

Получение результатов

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

{
"apikey": "b9eeХХХ….251",
"name": "название проекта",
"depth": 10,
"searchEngine": "Yandex",
"region": {
"type": ".ru",
"id": 213,
"lang": "ru"
},
"keywords": [
"семантика"
]
}

Пример ответа

{
"regionid": 213,
"keywords": [
{
"keyword": "string",
"urls": [
"https://ru.wikipedia.org/wiki/String_(C%2B%2B)",
"https://docs.microsoft.com/ru-ru/dotnet/api/system.string?view=netcore-3.1",
"https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/String",
"https://ravesli.com/urok-57-vvedenie-v-std-string/",
"https://javarush.ru/groups/posts/1411-klass-string",
"https://habr.com/ru/post/165597/",
"https://en.wikipedia.org/wiki/String_(computer_science)",
],
"titles": []
}
],
"leadingDomains": {
"ru.wikipedia.org": 1,
"docs.microsoft.com": 1,
"developer.mozilla.org": 1,
"ravesli.com": 1,
"javarush.ru": 1,
"javascript.ru": 1
}
}

Проверка индексации страниц сайта

Этот метод позволяет проверить индексацию страниц сайта в поисковых системах Яндекс и Google.

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

Проверка статуса

Получение результатов

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

{
"apikey": "b9eXXX….251",
"name": "stri5ng",
"urls": [
"https://www.rush-analytics.ru/pricing-plans"
],
"searchEngines": [
"Yandex",
"Google"
],
"googleCountry": ".ru",
"googleLanguage": "ru"
}

Пример ответа

1 — URL проиндексирован поисковой системой

0 — URL не проиндексирован поисковой системой

[
{
"url": "https://www.rush-analytics.ru/pricing-plans",
"yandexIndexed": "1",
"googleIndexed": "1"
}
]

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

Этот метод позволяет собрать поисковые подсказки с Яндекс, Google и Youtube.

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

Проверка статуса

Получение результатов

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

{
"apikey": "b9eХХХ….5251",
"name": "strin6g",
"yandexRegionId": 213,
"googleRegion": {
"country": ".ru",
"language": "ru"
},
"youtubeRegion": {
"country": ".ru",
"language": "ru"
},
"depth": 1,
"keywords": [
"семантическое ядро"
],
"stopwords": [
"бесплатно"
]
}

Пример ответа

{
"семантическое ядро": [
"семантическое ядро это простыми словами",
"семантическое ядро интернет магазина инструкция",
"семантическое ядро интернет магазина",
"семантическое ядро и ключевые слова разница",
"семантическое ядро сайта пример",
"семантическое ядро заказать",
"семантическое ядро заработок"
]
}

WORDSTAT

Этот метод позволяет собрать ключевые слова и частотность из Яндекс Wordstat.

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

Проверка статуса

Получение результатов

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

{
"apikey": "acc99XXX…347dcef",
"name": "название проекта",
"regionid": 213,
"projecttype": "Keywords",
"pages": 10,
"keywords": [
"авто"
],
"stopwords": [
"string"
]
}

Пример ответа

{
"wordstatKeywordResult": [{
"keyword": "авто",
"collectedKeywords": [
{
"keyword": "авто",
"displays": 3113172
},
{
"keyword": "авто ру",
"displays": 560883
}
]
}
],
"regionid": 213
}

Adwords

Этот метод позволяет собрать частотность ключевых слов из Google Keyword Planner.

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

Проверка статуса

Получение результатов

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

{
"apikey": "acc99ХХХ…47dcef",
"name": "название проекта",
"googleRegion": {
"country": ".de",
"region": 9068242,
"language": "de"
},
"keywords": [
"auto"
],
"stopwords": [
"string"
]
}

Пример ответа

{
"adWordsKeywordResult": [
{
"keyword": "частотность запросов онлайн сервис",
"count": 120
}
]
}

Получение списка id созданных задач в конкретном инструменте

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

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

https://app.rush-analytics.ru/apiv2/projectids?apikey=acc...XXX7dcef&projecttype=2

Пример ответа

{
"1": [
{
"id": "182713",
"name": "тест мобилка апи",
"created": "2018-06-04 16:41:01+00",
"keywordcount": "1"
},
{
"id": "183096",
"name": "name",
"created": "2018-06-07 09:09:45+00",
"keywordcount": "1"
{
"id": "734520",
"name": "название проекта",
"created": "2021-08-10 06:54:11+00",
"keywordcount": "1"
}
]
}

Проверка баланса лимитов

Этот модуль позволяет проверить остаток лимитов на балансе тарифного плана.

Для этого вам необходимо добавить ваш  apikey к запросу:

https://app.rush-analytics.ru/apiv2/balance?apikey=b9ХХХ...5251

Ошибки

Все методы API могут возвращать следующие коды ошибок