< Back to zoomrank.com

Retrieve Keyword

URL

http://vendor.zoomrank.com/accounts/:account_id/keywords/:id.json

Supported formats

JSON

Supported request methods

GET

Example

Retrieve keyword with ID 1 belonging to account with ID 2

http://vendor.zoomrank.com/accounts/2/keywords/1.json

General Arguments

None

Filter Arguments

None

Keyword Object

Field Description Format
external_id Your unique identifier char(125)
engine_id Search engine ID 1 = Google
2 = Yahoo
3 = Bing
term Search term
mobile mobile or SERP true = mobile keyword
false = SERP keyword
country Country See Supported Countries
language Language (Google Only) See Supported Languages
location Search Location (Google Only) City,ST
dow Weekly ranking day-of-week 0 - 6 (0 = Sunday)
last_processed_date Date of which record was last processed YYYY-MM-DD

Response Codes

200 - Success
404 - No records found
500 - Unexpected error. Try again.

Example Response

{
	"id": 1,
	"external_id": "1234",
	"engine_id": 1,
	"term": "monitor search engine rankings",
	"mobile": false,
	"country": "US",
	"language": "EN",
	"location": "Dallas,TX",
	"dow": null,
	"result": {
		"date": "2012-05-01",
		"number_of_results": 5200000,
		"serps": {
			"1": {
				"local": false,
				"domain": "zoomrank.com",
				"url": "http://www.zoomrank.com",
				"page": 1
			},
			"2": {
				"local": false,
				"domain": "macupdate.com",
				"url": "www.macupdate.com/app/mac/26316/serank",
				"page": 1
			},    
			... 100
		}	  
	}
}