< Back to zoomrank.com

Retrieve a specific SERP keyword

URL

https://api.zoomrank.com/users/:user_id/serp/keywords/:id.xml

Supported formats

xml, json

Supported request methods

GET

Example

Retrieve SERP keyword with ZoomRank ID 1200 for user with ZoomRank ID 1.

https://api.zoomrank.com/users/1/serp/keywords/1200.xml

Response Codes

200 - Success
404 - No records found

Example Response

<keyword id="1200">
	<user_id>1</user_id>
	<external_id>EXTID01</external_id>
	<category_id>1</category_id>
	<url>wikipedia.org</url>
	<keyword>wiki</keyword>
	<last_ranked_date>2011-03-25</last_ranked_date>	
	<engines>
		<engine id="1">
			<name>Google</name>
			<country>US</country>
			<language>EN</language>
			<location>San Jose,CA</location>
		</engine>
		<engine id="2">
			<name>Yahoo</name>
			<country>US</country>
			<language/>
			<location/>
		</engine>
		<engine id="3">
			<name>Bing</name>
			<country>US</country>
			<language/>
			<location/>
		</engine>
	</engines>	
	<rankings>	
		<ranking id="10" engine_id="1">
			<date>2011-03-25</date>
			<combined>
				<number_of_results>774000000</number_of_results>
				<type>O</type>
				<page>1</page>
				<rank>1</rank>
				<change>0</change>
				<url>en.wikipedia.org/wiki/Wiki</url>
			</combined>
			<organic>
				<page>1</page>
				<rank>1</rank>
				<change>0</change>
			</organic>
			<local>
				<number_of_results>0</number_of_results>
				<type/>
				<rank>0</rank>
				<change>0</change>
			</local>
		</ranking>
		<ranking id="11" engine_id="2">
			<date>2011-03-25</date>
			<combined>
				<number_of_results>13500000</number_of_results>
				<type>O</type>
				<page>1</page>
				<rank>1</rank>
				<change></change>
				<url>en.wikipedia.org/wiki/Wiki</url>
			</combined>
			<organic>
				<page>1</page>
				<rank>1</rank>
				<change></change>
				<url>en.wikipedia.org/wiki/Wiki</url>
			</organic>
			<local>
				<number_of_results>0</number_of_results>
				<type/>
				<rank>0</rank>
				<change>0</change>
			</local>
		</ranking>
		<ranking id="12" engine_id="3">
			<date>2011-03-25</date>
			<combined>
				<number_of_results>13500000</number_of_results>
				<type>O</type>
				<page>1</page>
				<rank>1</rank>
				<change></change>
				<url>en.wikipedia.org/wiki/Wiki</url>
			</combined>
			<organic>
				<page>1</page>
				<rank>1</rank>
				<change></change>
				<url>en.wikipedia.org/wiki/Wiki</url>
			</organic>
			<local>
				<number_of_results>0</number_of_results>
				<type/>
				<rank>0</rank>
				<change>0</change>
			</local>
		</ranking>			
	</rankings>
</keyword>