API for developers

Description of the Rush Analytics API

Getting started

Authorization

To use the Rush Analytics API, you must get an API key, which can be found in your Rush Analytics user account. Use it for all API requests. 

If an API method is activated without an API key or an invalid API key is passed in the request, the server returns an “Invalid API key” error. 

Getting an API Key 

To start using the API:

  • Login to your account;
  • Go to menu -> API;
  • Click the “Get API-key” button.

Please note that API is supported only on Pro and higher Subscription Plans. There is no access to API оn Start Subscription plan. 

Return format 

Task results are available in Json format and Excel files.

Limits and restrictions 

To ensure uninterrupted work of API for all clients, we limit the speed of sending requests. Any API method can be accessed no more than once per second.

If the client application makes more than 1 request per second, then our server will return an error, if the speed is not reduced – your IP will be temporarily blocked. Different subscription plans have different numbers of concurrent API threads.

  • Pro plan – 1 thread.
  • Pro+ – 10 threads.
  • Team – 20 threads.
  • Business – 30 threads.
  • Business+ – 50 threads.
  • Corp – 100 threads.

API thread allows you to run 1 task, check the project status or get results. Until the request is completed, you won’t be able to make a second request to the API. For example: if you have started 1 task – you will be able to start another task or check its status only after the started task is ready. As long as it is in the process of data collection, you cannot create a new task, check the status or get results on another task. 

Request Parameters

To test the API: https://app.rush-analytics.com/apiv2/doc/

List of languages – https://app.rush-analytics.com/apiLanguages.php

List of region IDs in Google – https://app.rush-analytics.com/apiRegionsGoogle.php

 List of region IDs in Yandex – https://app.rush-analytics.com/apiRegionsYandex.php

Basic information

Documentation for the API can be found at https://app.rush-analytics.com/apiv2/doc/

From a practical point of view – the API passes your data to Rush Analytics to create a task in the system, which gets in line for parsing. You check the status of the task with your application, and as soon as it is ready – you get the result. 

API usage prices: 

All prices are identical to regular task creation in Rush Analytics – prices are available on page: https://rush-analytics.com/pricing-plans

Rank tracker

This method allows you to get a list of positions and relevant URLs by keywords for several search engines, as well as URLs of topic leaders and their positions. 

Request Parameter 

TitleFormatDescriptionExample
apikeystringYour API keyn/a
namestringName of taskChecking positions for website “X”
urlstringurl or domain of the site for which the position is checkedhttps://rush-analytics.com/
competitorsstringthe domain of a competitor’s website. Up to 10 domains can be enteredhttps://site24.com
dataCollectionFrequencyintFrequency of collection:
0 – daily,
1 – weekly,
2 – in manual mode,
3 – by day of the week.
0, 1, 2 etc.
daysstringUsed when selecting to collect data on specific days.
Day designation: 0,1,2,3,4,5,6.
0 – Monday,
1 – Tuesday, etc.
If more than one day is to be specified, separate them with a comma.
0, 1, 2 etc.
hourintStart time for data collection.
Format: 0 – 23, where 0 – 0:00; 1 AM – 01:00.
10
yandexRegionsYandex search engine region
googleRegionsGoogle search engine region
typestringDomain area .com
IdintId region of the search engine.
List of Yandex regions –https://app.rush-analytics.com/apiRegionsYandex.php
List of Google regions – https://app.rush-analytics.com/apiRegionsGoogle.php
213
langstringThe language in which the data will be collected is – https://app.rush-analytics.com/apiLanguages.phpen
deviceintThe device on which the data will be collected:
0 – Desktop
1 – Mobile
0
keywordsstringKeywordssemantic core
target urlstringTarget URLhttps://rush-analytics.com/
groupstringName of the keyword groupsemantic

Example request


{
 "apikey": "1ae...af4b",
"name":"google reg",
 "url":"https://apple.com/",
 "competitors":[
   "https://samsung.com"
 ],
 "dataCollectionFrequency":{
   "frequency":0
 },
 "yandexRegions":[
   {
     "type":".ru",
     "id":213,
     "lang":"ru",
     "device":0
   }
 ],
 "googleRegions":[
   {
     "type":".de",
     "id":1003854,
     "lang":"de",
     "device":0
   },
   {
     "type":".ae",
     "id":1000010,
     "lang":"en",
     "device":1
   },
   {
     "type":".ae",
     "id":1000011,
     "lang":"en",
     "device":1
   },
   {
     "type":".ae",
     "id":1000012,
     "lang":"en",
     "device":1
   },
   {
     "type":".ae",
     "id":1000013,
     "lang":"en",
     "device":1
   }
 ],
 "keywords":[
   {
     "keyword":"phone",
     "targeturl":"https://apple.com/",
     "group":"mobile"
   }
 ]
}

Checking status

GET /status/

TitleFormatDescription Example
apikeystringYour API keyn/a
Type idintId check position3
Project idintTask Id330098

Getting the result

GET /results/

TitleFormatDescriptionExample
apikeystringYour API keyn/a
Project idintTask Id330098
pageintThe number of the results page:
1 – first 1000 results.
2 – results from 1001-2000 etc.
1
periodStartString($date)Get results from the date2021-09-13
periodEndString($date)Get the results, ending with the date2021-12-14
competitorsstringCompetitor’s domain.
Used only to obtain results for competitor positions
site.com

Example of a request to get results from the position dynamics tab

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

Example of a response

[{
  "keywords": [
    {
      "keyword": "phone",
      "wordstat": 521,
      "wordstat ''": 113,
      "wordstat '!'": 53,
      "group": "mobile",
      "targeturl": "https://www.apple.com",
      "relevanturl": "https://www.apple.com/",
      "positions": [
        {
          "date": "08.12.2021",
          "position": "16"
        },
        {
          "date": "14.12.2021",
          "position": "24",
          "diff": -8
        }

]

Example request to get results from the visibility tab

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

Example of a response

{
  "visibility": [
    {
      "traffic": 1358,
      "group": "Mobile",
      "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
        }
      ]
    }
  ]
}

Example request for a list of competitors (needed to get positions by competitors)

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

Example of a response

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

Example request for a list of project regions

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

Example of a response

[
{
  "searchEngine": [
    {
      "id": 33091,
      "name": "Google.com - Switzerland (20133)",
      "device": "desktop"
    },
    {
      "id": 33094,
      "name": "Google.ae - Greece (20361)",
      "device": "mobile"
    }
  ]
}
]

Example of a request to get a position history

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

Example of a response

[
{
    "keyword": "phone",
    "positions_history": [
      {
        "date": "14.12.2021",
        "position": "24 (-8)"
      },
      {
        "date": "08.12.2021",
        "position": "16"
      }

]

Example of a request to retrieve a URL history

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

Example of a response

[
{
    "keyword": "phone",
    "target_url": "/iphone-13-pro/key-features/",
    "urls_history": [
      {
        "date": "14.12.2021",
        "url": "https://www.apple.com/iphone-13-pro/key-features/"
      },
      {
        "date": "08.12.2021",
        "url": "https://www.apple.com/iphone-13-pro/key-features/com"
      }
]

Example of a request to retrieve a snippet history

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

Example response

[
{
    "keyword": "phone",
    "position": "24",
    "snippets_history": [
      {
        "date": "14.12.2021",
        "snippet": "iPhone 13 Pro takes a huge leap forward, bringing incredible speed to everything you do and dramatic new photo and video capabilities — all in two great sizes."
      },
      {
        "date": "08.12.2021",
        "snippet": "See the Apple Card Customer Agreement for more information. ACMI is not available for purchases made online at the following special stores: Apple Employee Purchase Plan"
      }

]

Example of a request to get visibility on competitors

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

Example response

[
{
    "competitor": "Samsung.com",
    "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%)"
      }


]

Example of a request for topic leaders

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

Example response

[
{
    "competitor": "samsung.com",
    "top10_info": [
      {
        "date": "14.12.2021",
        "top10_keywords": 14
      }
    ]
  },
  {
    "competitor": "planfact.io",
    "top10_info": [
      {
        "date": "14.12.2021",
        "top10_keywords": 52
      }
    ]
  },

]

Example of a request to get competitors’ positions

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

Example response

[
{
    "keyword": "phone",
    "wordstat": 521,
    "group": "mobile",
    "positions": [
      {
        "date": "08.12.2021",
        "position": "> 100"
      },
      {
        "date": "14.12.2021",
        "position": "> 100"
      }
    ]
  },
  {
    "keyword": "iPhone",
    "wordstat": 521,
    "group": "mobile",
    "positions": [
      {
        "date": "08.12.2021",
        "position": "> 100"
      },
      {
        "date": "14.12.2021",
        "position": "> 100"
      }
]

Example of a request to get a comparison of positions by region

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

Example response

[
"keyword": "iPhone",
    "regions_positions": [
      {
        "region": "Google.com - Switzerland (20133)",
        "device": "desktop",
        "lang": "de",
        "id": 328368,
        "date": "14.12.2021",
        "position": "1"
      }
]

Rank tracker Light

 This method allows you to get a list of positions, relevant URLs by keywords, as well as URLs of topic leaders. 

Request parameter

itleFormatDescriptionExample
apikeystringYour API keyn/a
namestringName of taskChecking positions for website “X”
urlstringurl or domain of the site for which the position is checkedhttps://rush-analytics.com/
yandexRegionsYandex search engine region
googleRegionsGoogle search engine region
typestringDomain area .com
IdintId region of the search engine.
List of Yandex regions –https://app.rush-analytics.com/apiRegionsYandex.php
List of Google regions – https://app.rush-analytics.com/apiRegionsGoogle.php
213
langstringThe language in which the data will be collected is – https://app.rush-analytics.com/apiLanguages.phpen
deviceintThe issuing device on which the data will be collected:
0 – Desktop
1 – Mobile
0
keywordsstringKeywordssemantic core

Getting the result

TitleFormatDescriptionExample
apikeystringYour API keyn/a
Project idint Task id 324234

Checking status

TitleFormatDescription Example
Type idintId Rank tracker Light1
Project idint Task id 324234
apikeystringYour API keyn/a

Example request

{
"apikey": "acc99ХХХ…dcef",
"name": "Name",
"url": "rush-analytics.com",
"yandexRegions": [
{
"type": ".ru",
"id": 213,
"lang": "ru",
"device": 0
}
],
"googleRegions": [
{
"type": ".de",
"id": 2311976,
"lang": "de",
"device": 0
}
],
"keywords": [
"phone"
]
}

Example response

[
{
"regionid": "20256",
"searchEngine": "Google",
"device": "0",
"keywords": [
{
"keyword": "phone",
"position": "19",
"url": "https://www.apple.com/ipad/compare/"
}
],
"leadersOfTheme": [
{
"domain": "ru.wikipedia.org",
"visibility": 1
},
{
"domain": "TexTerra.ru",
"visibility": 1
},
}
]
},
{
"regionid": "1011969",
"searchEngine": "Google",
"device": "0",
"keywords": [
{
"keyword": "iPhone",
"position": "10",
"url": "https://www.apple.com/"
}
],
"leadersOfTheme": [
{
"domain": "ru.wikipedia.org",
"visibility": 1
},
{
"domain": "texterra.ru",
"visibility": 1

}
 ]

Collecting the TOP 10 URLs

This method allows you to get the top 10-100 URLs by keywords, as well as URL topic leaders. 

Example request

TitleFormatDescriptionExample
apikeystringYour API keyn/a
namestringName of taskChecking positions for website “X”
depthintParsing depth (10,20, 30, 40, 50, 60, 70, 80, 100)10
searchEnginestringSearch engine (Yandex or Google)Google
typestringDomain area.com
IdintId region of the search engine.
List of Yandex regions –https://app.rush-analytics.com/apiRegionsYandex.php
List of Google regions – https://app.rush-analytics.com/apiRegionsGoogle.php
1003854
langstringThe language in which the data will be collected is – https://app.rush-analytics.com/apiLanguages.phpde
keywordsstringKeywordsphone

Checking status

TitleFormatDescriptionExample
apikeystringYour API keyn/a
Project idint Task id 324234

Getting the results

TitleFormatDescriptionExample
apikeystringYour API keyn/a
Project idint Task id 324234

Example request

{
"apikey": "b9eeХХХ….251",
"name": "Name",
"depth": 10,
"searchEngine": "Google",
"region": {
"type": ".de",
"id": 1003854,
"lang": "de"
},
"keywords": [
"phone"
]
}

Example response

{
"regionid": 1003854,
"keywords": [
{
"keyword": "phone",
"urls": [
"https://www.apple.com/ipad/compare/",
"https://https://www.apple.com/ipad-pro/",
],
"titles": []
}
],
"leadingDomains": {
"ru.wikipedia.org": 1,
"docs.microsoft.com": 1,
"developer.mozilla.org": 1,
"ravesli.com": 1
}
}

Checking the site indexing

This method allows you to check the indexing of pages in web search engines Yandex and Google. 

Example request

TitleFormatDescriptionExample
apikeystringYour API keyn/a
namestringName of taskChecking positions for website “X”
urlsstringURLs for checking.https://rush-analytics.com/pricing-plans
searchEnginesstringSearch engine (Yandex, Google)“”Yandex”, “Google”
googleCountrystringGoogle region domain area.com
googleLanguagestringThe language of the Google regionen

Checking status

TitleFormatDescriptionExample
apikeystringYour API keyn/a
Type idintId for indexing (5)1
Project idint Task id 324234

Example response

TitleFormatDescriptionExample
apikeystringYour API keyn/a
Project idint Task id 324234

Example request

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

Example response

1 – URL indexed by a search engine

0 – URL not indexed by search engine

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

Keyword suggest tool

This method allows you to collect search suggestions from Yandex, Google and Youtube. 

Request parameters

TitleFormatDescriptionExample
apikeystringYour API keyn/a
namestringName of taskChecking positions for website “X”
yandexRegionsintList of Yandex regions –https://app.rush-analytics.com/apiRegionsYandex.php
googleRegionsintList of Google regions – https://app.rush-analytics.com/apiRegionsGoogle.php
countrystringGoogle domain area, Youtube domain area.com
languagestringLanguage of Google, Youtube region – https://app.rush-analytics.com/apiLanguages.phpen
youtubeRegionAdding a Youtube region
depthintDepth of data collection (1, 2, 3).
We recommend selecting 1
1
keywordsstringkeywordsphone
stopwordsstring Negative keywords – remove unnecessary keywords found free

Checking status

TitleFormatDescriptionExample
apikeystringYour API keyn/a
Type idintId for Keyword suggest tool(7)7
Project idint Task id 324234

Getting the results

TitleFormatDescriptionExample
apikeystringYour API keyn/a
Project idint Task id 324234

Example request

{
"apikey": "b9eХХХ….5251",
"name": "Name",
"yandexRegionId": 177,
"googleRegion": {
"country": ".de",
"language": "de"
},
"youtubeRegion": {
"country": ".de",
"language": "de"
},
"depth": 1,
"keywords": [
"phone"
],
"stopwords": [
"free"
]
}

Example response

{
"phone guru martinsried",
    "phone gimbal",
    "phone guy",
    "phone guy death",
    "phone guy death reaction",
    "phone green screen footage",
    "phone guy calls fnaf 1",
  
]
}

Yandex Keyword Research

This method allows you to collect keywords and search volume from Yandex Wordstat.

Request parameters

TitlleFormatDescriptionExample
apikeystringYour API keyn/a
namestringName of taskChecking positions for website “X”
regionidintId region of the Yandex search engine.
The list of IDs is https://app.rush-analytics.com/apiRegionsYandex.php
213
projecttypestringWhat to collect: keywords or frequency ( Keywords /SearchVolume)Keywords
pagesintParse pages in the left-hand column of Wordstat (1-10/40)
This parameter is only specified when collecting keywords.
1
normalstringTotal search volume. Specified only for search volume collection tasks.true
parenthesisstringPartial occurrence. Search volume of the word type. Specified only for search volume collection tasks.true
exclamationstring Search volume of type “!exact !occurrence”. Specified only for search volume collection tasks.true
wordorderstring Search volume with word order taken into account. Used together with exclamation, parenthesis, normal. Specified only for keyword ordering search volume collection tasks.true
minimumwordstatintFiltering that removes queries with a search volume equal to or lower than the specified level from the results. (may not be used)0
keywordsstringkeywordsPhone
stopwordsstringNegative keywords – remove unnecessary keywords foundFree

Checking the status

TitleFormatDescriptionExample
apikeystringYour API keyn/a
Type idintId for Yandex Keyword Research (4)4
Project idint Task id 324234

Example response

TitleFormatDescriptionExample
apikeystring Your API key n/a
Project idint Task id 324234

Example request

{
"apikey": "acc99XXX…347dcef",
"name": "Name",
"regionid": 213,
"projecttype": "phone",
"pages": 10,
"keywords": [
"mobile"
],
"stopwords": [
"free"
]
}

Response example

{
"wordstatKeywordResult": [{
"keyword": "phone",
"collectedKeywords": [
{
"keyword": "mobile",
"displays": 3113172
},
{
"keyword": "land",
"displays": 560883
}
]
}
],
"regionid": 21346
}

Search volume checker

This method allows you to collect the search volume of keywords from Google Keyword Planner 

Request parameters

TitleFormatDescriptionExample
apikeystringYour API keyn/a
namestringName of taskChecking positions for website “X”
googleRegionGoogle search engine
countrystringDomain area in Google.com
regionintId region Google.
The list of IDs is
https://app.rush-analytics.com/apiRegionsGoogle.php
2756
languagestringThe language in which the data will be collected is – https://app.rush-analytics.com/apiLanguages.phpen
keywordsstringkeywordsphone
stopwordsstringNegative keywords – remove unnecessary keywords foundfree

Checking the status

TitleFormatDescriptionExample
apikeystringYour API keyn/a
Type idintId for Search volume checker(15)15
Project idint Task id 324234

Example response

TitleFormatDescriptionExample
apikeystring Your API key n/a
Project idintTask id324234

Example request

{
"apikey": "acc99ХХХ…47dcef",
"name": "Name",
"googleRegion": {
"country": ".de",
"region": 9068242,
"language": "de"
},
"keywords": [
"auto"
],
"stopwords": [
"free"
]
}

Example response

{
"adWordsKeywordResult": [
{
"keyword": "iPhone 13 Pro max",
"count": 120
}
]
}

Get a list of the id of tasks created in a specific tool

Request parameters

TitleFormatDescriptionExample
apikeystringYour api keyn/a
namestringName of task Checking positions for website “X”
TypeintTypes of tasks:
1 – Rank tracker,
2 – Collecting the top 10 URLs,
5 – Checking the site indexing,
7 – Keyword suggest tool,
4 – Yandex Keyword Research,
15 – Search volume checker.

Example request

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

Example response

{
"1": [
{
"id": "182713",
"name": "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": "QWERTY",
"created": "2021-08-10 06:54:11+00",
"keywordcount": "1"
}
]
}

Credit balance check 

This module allows you to check the balance of your plan.

To do this, you need to add your API key to the request:

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

Errors 

All API methods can return the following error codes

ErrorCodeDescriptionSolution
Error: Forbidden403No more free API threadsThere are no free threads left. Upgrade your subscription with more threads or wait.
Bad Request400Unknown project type Some of the data required to create the task is missing from the request.
Bad Request400Invalid API keyCheck that the API key has been entered correctly
Bad Request400Google/Yandex region xxx is not supportedCheck that the region id is correct
Bad Request400cannot be converted to valid domainYou have entered an invalid domain. Check it and enter a valid domain.
Bad Request400Region «ххх» is not valid for domain “хх»You made a mistake when entering the “type” parameter – check it and make sure the domain case is in the correct format.
Bad Request400“xxx” is not supported Yandex / Google languageYou have made a mistake in the “lang” parameter. – Check it and make sure the language is in the correct format.
Bad Request400Region device parameter must be either 0 or 1You have made a mistake in the “device” parameter Change the data to 0 (desktop) or 1 (mobile)
Bad Request400API key not found in requestAdd an API key to the request.
Bad Request400All your keywords were filtered out by stopwordsAll keywords have been removed by stop words. Check your stop words and repeat the request.
Bad request400Country missing from google regionAdd a country for the region you specify. Example “.com”
Bad request400
Country missing from youtube region
Add a country for the region you specify. Example “.com”
Bad request400Depth missing from parametersSpecify the depth of collection of search suggestions “1-3”
Bad request400Empty URLSet the domain of the site to check the positions.
Bad request400Empty nameSpecify the name of the task.
Internal Server Error500Error has occured, please try again later” . $e->getMessage()An error has occurred. Check the request and repeat it again.
Bad request400Failed to find project $projectid of type $projecttypeNameThe task was not found. Repeat the request again or contact our support team.
Bad request400GoogleRegion missing from parametersSpecify the Google region for your task.
Bad request400Invalid depth, allowed depths are ” . join(‘,’, $allowedDepths)You have entered the wrong data collection depth parameter in the search suggestions. Replace it with 1-3
Bad request400Keywords missing from parametersAdd keywords to the task.
Bad request400Language missing from google regionAdd a language for the Google region.
Bad request400Language missing from youtube regionAdd a language for the Youtube region.
Bad request400Maximum keyword length is 2000 charactersIn the rank tracker, the maximum allowable keyword length is 2000 characters. Reduce the length of your keywords.
Bad request400Missing apikey parameterAdd an API key to the request.
Bad request400Name missing from parametersSpecify the name of the task.
Forbidden403Not allowed to create project through APIYour subscription plan does not have API access. Upgrade to a plan with API access.
Bad request400Not authorizedNot authorized. Contact our support team.
Bad request400Not enough credits.There are not enough credits on your plan to create a task. Buy more credits.
Bad request400Please choose at least one type of search volume: normal, parenthesis or exclamationTo create a task, at least 1 of the search volume types must be set as “true”
Bad request400Project does not existThe task does not exist
Bad request400Project is not in done statusThe task is being processed. Repeat the request later.
Bad request400Project with ID $projectid of type $projecttype does not existThe task does not exist
Bad request400Projecttype missing from parametersSpecify the PROJECTTYPE for the task.
Bad request400Region missing from google regionSpecify the region’s id.
Bad request400Region missing from parametersThe region of data collection is not specified.
Bad request400Regionid missing from parametersSpecify the region’s id.
Bad request400Request body is not a valid JSONCheck the validity of your request.
Bad request400URL missing from parametersSet the domain of the site to check the positions.
Bad request400URLs missing from parametersSet the URL to check indexation.
Bad request400Unknown API functionUnknown API function.
Bad request400Unknown project type ‘$projectTypeString’The PROJECTTYPE is not set correctly. Example of a valid PROJECTTYPE for the yandex keywords research tool “Keywords” or “SearchVolume”
Bad request400Unsupported search engine. Supported types: Google, YandexSearch engines that are supported: “Yandex and Google
Bad request400You must choose at least 1 keywordYou need to add keywords to the task.
Bad request400You must choose at least 1 regionAt least 1 region must be added to the task.
Bad request400You must fill at least one URLA URL must be added to the task to check indexing.
Bad request400You must input at least 1 keywordYou need to add keywords to the task.
Bad request400You must choose at least 1 keywordYou need to add keywords to the task.
Bad request400You must select at least one region typeAt least 1 region must be added to the task.
Bad request400You must select at least one search engine. Google or Yandex.At least 1 search engine must be added.
Bad request400You need to select at least one regionAt least 1 region must be added to the task.
Bad request400googleCountry parameter is emptyNeed to add a country parameter to check if the site is indexed by Google
Bad request400googleLanguage parameter is emptyNeed to add a language parameter to check if the site is indexed by Google