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
- Success404
- No records found500
- 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 } } }