API Errors

How are sent messages and error codes?

Errors are retrieved using standard HTTP error code syntax. Any additional info is included in the body of the return call in JSON format.

Error codes that are not listed here can be found in the GeoRanker REST API functions documentation.

Error Example

JSON-formatted error
	"status": "401",
	"msg": "Bad or expired API Key.",
	"solution": "To fix this make sure you api key.",
	"command": "/report/124.json?email=example@domain.com&apikey=92a06a967cc8a6c96as560ec5570bb2e91",
	"time": "2015-04-13 20:43:07",
	"debug": {
		"line": 36,
		"file": "checksession.php",
		"lastsqlerror": null,
		"rawphpinput": ""

Standard API errors

Http/Api error codeDescription
400Bad input parameter. Error message should indicate which one and why.
403Bad API Key. Re-authenticating the user won't help here. Your key may have been mistyped or you do not have access to our API.
404File or folder not found at the specified path.
405Request method not expected.
503Your app is making too many requests and is being rate limited. 503s can trigger on a per-IP or per-user basis.
507User has no credits left.
5xxInternal server error.

GeoRanker API Testimonials

James Richardson

SEO & PPC Professional - Optimising


Not only is GeoRanker a great option for our client reports, the API options have allowed us to create game-changing tools that we use for our clients, saving us thousands of dollars every month by cutting down our reporting time. GeoRanker has changed our business in a big way.

Nyagoslav Zhekov

Managing Director, NGS Marketing


GeoRanker is a unique SEO tool. It could be helpful for both small businesses and national brands. The former could use its functionality to do competitive research on other businesses in the same industry across the country, while the latter (brands) could benefit from its ease of reporting localized rankings in multiple cities and at the same time providing insights into how direct competitors are doing. I highly recommend it.

Steve Wiideman

Xivic Inc., xivic.com Search Marketing Director


GeoRanker is a cost-effective solution that allows us to research, collect, and monitor key local SEO focal points across thousands of individual franchises. Thanks to the API, we now have the ability to find and aggregate global and industry-specific opportunities. We're fortunate to have found GeoRanker, with their incredible customer service and technical expertise, and look forward to years of dominating local search results for our clients!