< Back to zoomrank.com

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 - Success
404 - 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
			}
		}
	},
	....
]