API Key:

Upon registering for the Trackur API service, you will be given a 36-digit Universally Unique Identifier (UUID). This key acts as your password for API access. This key is used to track how many results per day your account has looked up, as well as the maximum number of results the account is allowed.

API Syntax:

For the purposes of all examples, we’ll use “00000000-0000-0000-0000-000000000000” as the API key. In your queries, replace 00000000-0000-0000-0000-000000000000 with the API key given to you when you sign up.

For basic functionality, you can simply use

http://api.trackur.com/index.php/api/Format/Your API Key/Query

The Trackur API currently supports XML and JSON output, and defaults to XML.

For XML:

http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/iphone

For JSON:

http://api.trackur.com/index.php/api/json/00000000-0000-0000-0000-000000000000/iphone

A number of options are also available to help filter results to just the ones you want, or to get the most out of each API query. The first two are Result Count and Starting Point. By default, the API will return the first 50 results found for your query. By changing the Result Count and Starting Point, you can browse the full list of results (Up to your maximum daily requests). to use these, the format is

http://api.trackur.com/index.php/api/Format/Your API Key/Query/Result count/Starting Point

Permitted Characters:  ’a-z 0-9~%&.,:_-()’;  (quotes are not needed to achieve exact match of multi-word keywords). Note, you will need to encode/escape characters.

To get the first 100 results:

http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/iphone/100

To get the second 50 results:

http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/iphone/50/50

This will also get the second 50 results, using the default value for Result Count:

http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/iphone//50

To get the second 100 results:

http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/iphone/100/100

To get results from 51 to 150:

http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/iphone/100/50

As with Trackur’s search function, you can also filter your results by source, specific included or excluded words, and domain.

To use an Include:

http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/iphone/100/50/ringtones

To use multiple Includes:

http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/iphone/100/50/ringtones,itunes

To use an Exclude:
http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/Andy Beal/100/50/Social Media/Beal Financial Corporation

To use multiple Excludes:
http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/Andy Beal/100/50/Social Media/Beal Financial Corporation,Texas

To exclude a Domain (Do not include http://):
http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/Andy Beal/100/50/Social Media/Beal Financial Corporation/www.bealbank.com

To exclude multiple Domains (Do not include http://):
http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/Andy Beal/100/50/Social Media/Beal Financial Corporation/www.bealbank.com,www.dallasnews.com

To limit by source (Valid sources are News, Reddit, GooglePlus, Delicious, Twitter, Facebook, Media, and Forums):
http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/Andy Beal/100/50/Social Media/Beal Financial Corporation/www.bealbank.com/Blogs

To limit to a few sources:
http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/Andy Beal/100/50/Social Media/Beal Financial Corporation/www.bealbank.com/Blogs,Twitter
The default is set to include all sources.
To omit a filter, leave the space empty.

To only use an Exclude:
http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/Andy Beal/100/50/null/Beal Financial Corporation

To only exclude a domain (Do not include http://):
http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/Andy Beal/100/50/null/null/www.bealbank.com

To limit results by date (unix timestamp format, which is +0 gmt):

http://api.trackur.com/index.php/api/xml/00000000-0000-0000-0000-000000000000/iphone/null/null/null/null/null/null/date_start/date_end

URLs for browsing the results with your current settings will be generated at the end of the output. Using these URLs, you can automatically create links to go forward and back in your results.

NOTE: Your first call for any new query will most likely not return results. This is intentional and is designed to “prime” Trackur. After an initial wait period of 60 minutes, your query will start generating results.

API Response:

On a successful API request, the response has the following structure:

	Response
		Link (The URL used to generate the API response)
		User
			ID
                        RequestTime
			RequestsUsed
			RequestLimit
                        Hourlyuse
		Results
			Result
				Title
				Source
                                Influence
				Published
				URL
				Content
                                Sentiment
			Result
				Title
				Source
                                Influence
				Published
				URL
				Content
                                Sentiment
			...
		Navigation
			Previous (If not on first page)
			Next

On failure, the response structure is:

	Response
		Link (The URL used to generate the API response)
		Error