Last 7 days, UTC

Average Latency
405ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time

Simple & Straightforward Pricing

Pay as you go. No long-term contracts.

Freemium

$0

additional fees may apply

Keywords

50 / day

$0.0050 per extra

Get Rankings Within 24 Hours

7 Day Data Storage

Get Rankings + URL Data For Upto 4 Websites

150+ Google Engines Supported

Subscribe

premium

$179.95

per month

Keywords

10,000 / day

$0.0009 per extra

24 Hour Ranking Guarantee

7 Day Data Storage

Get Rankings + URL Data For Upto 4 Websites

150+ Google Engines Supported

Subscribe

Endpoints

HTTP 200 : Create Response POST/request/create
Output when create request is successful
						{
  "code": 200,
  "message": "Request successfully created - please check back for rankings using /request/rankings/id/XXXXX",
  "output": {
    "request_id": XXXXX,
    "key_count": 500,
    "request_date": "YYYY-MM-DD HH:MM:SS"
  }
}						
Create Request

Start by creating a request. Send us multiple keywords, your website's URL, up to 3 competitors & the search engine to be used. Then use the Get Rankings endpoint to fetch the rankings.


Test console
Description
Parameter
string

The full URL of your website
Example: yourwebsite.com

web_url

Required

string

The suffix of the Google engine (after 'google.' - note the period) to be used for this request. Defaults to "com"
Example: com

engine

Optional

string

Add your first competitor here
Example: yourcompetitor1.com

comp_url_1

Optional

string

Add your second competitor here
Example: yourcompetitor3.com

comp_url_2

Optional

string

Add your third competitor here
Example: yourcompetitor3.com

comp_url_3

Optional

string

The keywords for which rankings need to be checked. Separate multiple keywords with a comma (,)
Example: widgets, blue widgets, awesome widgets

keywords

Required

  • string – We could not process your request due to errors in your submission

    HTTP 104
  • string – We could not process your request due to an unknown error during saving your request. Please try again.

    HTTP 104
  • string – Your account has been suspended, please contact us for more information.

    HTTP 105
  • string – Unauthorized access. Please ensure your your Mashape key is authenticated.

    HTTP 106
  • string – Either your website URL or keywords were not found in your create request or were empty.

    HTTP 110
  • string – Engine not supported.

    HTTP 111
  • string – Unauthorized access. Please ensure your your Mashape key is authenticated.

    HTTP 107
HTTP 200 : Get Rankings Response GET/request/rankings/id/{request_id}
Output when rankings have successfully been fetched
						{
	"code": 200,
	"message": "Your request has been fulfilled & is now available for download until YYYY-MM-DD HH:MM:SS.",
	"output": {
		"request_id": "XXXXX",
		"keywords": [
			"widgets",
			"blue widgets"
		],
		"web_url": "widgets.com",
		"engine": "com",
		"comp_url_1": "bluewidgets.com",
		"comp_url_2": "greenwidgets.com",
		"comp_url_3": "orangewidgets.com",
		"create_date": "YYYY-MM-DD HH:MM:SS",
		"complete_date": "YYYY-MM-DD HH:MM:SS",
		"data_valid_till": "YYYY-MM-DD HH:MM:SS",
		"rankings": [
			{
				"keyword": "widgets",
				"web_rank": 0,
				"web_url": null,
				"comp_rank_1": "50",
				"comp_url_1": "http://www.bluewidgets.com/",
				"comp_rank_2": "15",
				"comp_url_2": "http://www.greenwidgets.com/green-widgets.html",
				"comp_rank_3": "21",
				"comp_url_3": "http://orangewidgets.com/orange.html"
			},
			{
				"keyword": "blue widgets",
				"web_rank": 30,
				"web_url": "http://www.widgets.com/blue.html",,
				"comp_rank_1": "17",
				"comp_url_1": "http://www.bluewidgets.com/",
				"comp_rank_2": "3",
				"comp_url_2": "http://www.greenwidgets.com/green-widgets.html",
				"comp_rank_3": "6",
				"comp_url_3": "http://orangewidgets.com/orange.html"
			},
		]
	}
}						
Get Rankings

Send us the request ID created by you previously, and we'll tell you your rankings. Rankings are generally returned in a few hours, but sometimes may take up to 24 hours.


Test console
Description
Parameter
number

The request ID for which rankings need to be fetched
Example: 13485

request_id

Required

  • string – Your request is being processed, please check back again in a couple of hours.

    HTTP 101
  • string – Invalid Request ID

    HTTP 100
  • string – Your request is under manual review, please check back later for details or contact us.

    HTTP 102
  • string – Request ID malformed

    HTTP 103

You must have an API key to test this API!


Mashape allows developers to find, consume, and distribute cloud APIs just like Google Rank Checker.

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.