< Back to zoomrank.com

Retrieve all SERP keywords

URL

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

Supported formats

xml, json

Supported request methods

GET

Example

Retrieve all SERP keywords within your group (paginated 100 per-page).

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

Arguments

Argument Description Format
page The page of results to return. Defaults to page 1.
user_id ZoomRank User ID. If this argument is provided, only SERP keywords matching will be returned.
user_external_id User External ID. If this argument is provided, only SERP keywords matching will be returned.
keyword_external_id Keyword External ID. If this argument is provided, only SERP keywords matching will be returned.
category_id ZoomRank Category ID. If this argument is provided, only SERP keywords matching will be returned.
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>
		<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>