UrlTrends API Documentation

Last Revised: Friday, August 26, 2005 1:35 PST

GetSearchTerms Call Information:

The GetSearchTerms call will allow you to see all of the keywords that you can find a Url by. The url is not required to be in our database to return records. If we know of any of the search terms for a url we will provide them to you.

GetSearchTerms Options:

GetSearchTerms accepts the following options when making a request.

Name Information (acceptable values) Required

command GetSearchTerms Yes

url The only valid value would be a Url Encoded string containing the url that you are requesting information on. Yes

apikey Your 64 character API key assigned to you. Yes

Note: All commands and their values are case sensitive. The only exception is the value for url.

You can make either HTTP GET or HTTP POST calls to our API server to access the information. Our API responds back with a simple XML response.

GetSearchTerms Example:

An example GET request would look like the following:

http://api.urltrends.com/api.php?command=GetSearchTerms&url=http%3A%2F%2Fwww.domainname.com&apikey=API_KEY_HERE

This example API call would return something similiar to the following:

<?xml version="1.0" encoding="utf-8"?>
<Result>
	<UrlInfo>
		<URL>http://www.urltrends.com</URL>
		<Summary>
			<TermsFound>4</TermsFound>
		</Summary>
		<Result>
			<Term>urltrends</Term>
			<Term>urltrends.com</Term>
			<Term>url trends</Term>
			<Term>Alexa Trend Rank</Term>
		</Result>
	</UrlInfo>
	<API>
		<ResponseCode>200</ResponseCode>

		<RemainingQueries>9987</RemainingQueries>
		<ExecTime>0.012</ExecTime>
	</API>
	<PassThru></PassThru>
</Result>

Name	Information (acceptable values)	Required
command	GetSearchTerms	Yes
url	The only valid value would be a Url Encoded string containing the url that you are requesting information on.	Yes
apikey	Your 64 character API key assigned to you.	Yes