Retrieve all SERP rankings for the specified keyword.
PLEASE NOTE: This method now returns all historical rankings for the keyword. The current rankings of a keyword can be retrieved from the keyword responses.
URL
https://api.zoomrank.com/users/:user_id/serp/keywords/:id/rankings.xml
Supported formats
xml, json
Supported request methods
GET
Example
Retrieve all SERP rankings for ZoomRank SERP keyword ID 1200.
https://api.zoomrank.com/users/1/serp/keywords/1200/rankings.xml
Arguments
Argument | Description | Format |
---|---|---|
page | The page of results to return. Defaults to page 1. | |
current | Filter results so that only the most current rankings are returned. | true |
engine_id | Filter results for a specific search engine (1 = Google, 2 = Yahoo, 3 = Bing) | 1, 2 or 3 |
from | Filter results FROM this date | YYYYMMDD |
to | Filter results TO this date | YYYYMMDD |
Response Codes
200
- Success404
- No records found
Example XML Response
<rankings> <ranking id="20120202" date="2012-02-02"> <engine id="1" name="google"> <combined> <number_of_results>13600000</number_of_results> <type>O</type> <page>1</page> <rank>1</rank> <change></change> <url>http://test.com</url> </combined> <organic> <page>0</page> <rank>0</rank> <change>0</change> <url/> </organic> <local> <number_of_results>0</number_of_results> <type/> <rank/> <change/> </local> </engine> <engine id="2" name="yahoo"> <combined> <number_of_results>13600000</number_of_results> <type>O</type> <page>1</page> <rank>3</rank> <change>-1</change> <url>http://test.com</url> </combined> <organic> <page>1</page> <rank>3</rank> <change>-1</change> <url>http://test.com</url> </organic> <local> <number_of_results>0</number_of_results> <type/> <rank/> <change/> </local> </engine> <engine id="3" name="bing"> <combined> <number_of_results>13600000</number_of_results> <type>O</type> <page>1</page> <rank>3</rank> <change>-1</change> <url>http://test.com</url> </combined> <organic> <page>1</page> <rank>3</rank> <change>-1</change> <url>http://test.com</url> </organic> <local> <number_of_results>0</number_of_results> <type/> <rank/> <change/> </local> </engine> </ranking> </rankings>
Example JSON Response
[ { id: 20120219, date: 2012-02-19, google: { combined: { number_of_results: 415000, type: "O", page: 1, rank: 1, change: 1, url: "http://www.test.com" } organic: { page: 1, rank: 1, change: 1, url: "http://www.test.com" } local: { type: null, number_of_results: 0 rank: null, change: null } }, yahoo: { combined: { number_of_results: 590291, type: "O", page: 1, rank: 2, change: 0, url: "http://www.test.com" } organic: { page: 1, rank: 2, change: 0, url: "http://www.test.com" } local: { type: null, number_of_results: 0, rank: 0, change: null } }, bing: { combined: { number_of_results: 590291, type: "O", page: 1, rank: 2, change: 0, url: "http://www.test.com" } organic: { page: 1, rank: 2, change: 0, url: "http://www.test.com" } local: { type: null, number_of_results: null, rank: null, change: null } } }, .... ]