< Back to zoomrank.com

Update Keyword

URL

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

Supported formats

JSON

Supported request methods

PUT

Example

Update keyword with ID 1 belonging to account with ID 2

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

Arguments

Argument Description Format
keyword The JSON object for the updated keyword (See example request) JSON

Considerations

Only the external_id field can be updated.

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 (updated)
304 - Not modified.
400 - Bad request. See error response.
500 - Unexpected error. Try again.

Example Request

{ "external_id": "4321" }

Example Response

{
	"id": 1,
	"external_id": "4321",
	"engine_id": 1,
	"term": "search engine ranking",
	"country": "US",
	"language": "EN",
	"location": "Dallas,TX",
	"dow": null,
	"last_processed_date": "2012-05-01"
}