< Back to zoomrank.com

Retrieve all SERP keywords

URL

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

Supported formats

xml, json

Supported request methods

GET

Example

Retrieve all SERP keywords (paginated 100 per-page) for user with ZoomRank ID 1.

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

Arguments

Argument Description Format
page The page of results to return. Defaults to page 1.
url The url of the ZoomRank SERP keyword. If this argument is provided, only SERP keywords matching will be returned.
external_id The external ID assigned to the ZoomRank keyword. If this argument is provided, only SERP keywords matching will be returned.

Response Codes

404 - No records found

Example Response

<keywords>
	<keyword id="1">
		<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>
</keywords>