Public API reference

getPublicTimeline

This method returns the latest 20 posts near a given location

This method doesn't require authentication

Parameters

We provide 4 different sets of parameters to find a location. Use the set you prefer for your app.
You can use only one at a time, here they are (best ones first).

Username

• user: The username of the user of whom to return the latest 20 posts near his latest known location

Latitude / Longitude (GPS Location)

• latitude: Numeric string for Latitude coordinates from -90 to +90(Use . (a dot) for decimal separator)
• longitude: Numeric string for Longitude coordinates from -180 to 180 (Use . (a dot) for decimal separator)

Cell ID / Location area code (GSM Location)

• cid: Numeric string of the Cell ID (related to your mobile phone network)
• lac: Numeric string for the Location Area Code (related to your mobile phone network)

Place string Location

• place: The geographical place of the post (UTF-8 encoded string). Twitxr prefers Google Maps string formats (City,Country / Address,City,Country and so on)

Example response

	<?xml version="1.0" encoding="UTF-8"?>
	<result code="done">
		<update id="2509">
			<user>victor</user>
			<avatar>http://twitxr.com/avatars/v/victor-80.jpg?t=1201089568</avatar>
			<url>http://twitxr.com/victor/updates/2509</url>
			<timestamp>1203350338</timestamp>
			<text>@harper http://threadless.com rules!!</text>
			<picture>http://twitxr.com/image/2509/th</picture>
			<reply>2507</reply>
			<location>
				<lat>41.960948</lat>
				<lng>2.835927</lng>
				<place>Carrer de Puigsacalm, 17005 Girona, Spain</place>
			</location>
			<source>
				<application>iPhone</application>
				<applicationURL>http://twitxr.com/iphoneclient/</applicationURL>
			</source>
		</update>
		<update id="2212">
			<user>twitxr</user>
			<url>http://twitxr.com/twitxr/updates/2212</url>
			<avatar>http://twitxr.com/avatars/t/twitxr-80.jpg?t=1201089568</avatar>
			<timestamp>1203334765</timestamp>
			<text>From now on you're going to see the source app off the post :)</text>
			<picture>http://twitxr.com/image/2212/th</picture>
			<reply></reply>
			<location>
				<lat>41.960948</lat>
				<lng>2.835927</lng>
				<place>Carrer de Puigsacalm, 17005 Girona, Spain</place>
			</location>
			<source>
				<application>iPhone</application>
				<applicationURL>http://twitxr.com/iphoneclient/</applicationURL>
			</source>
			<comment>
				<user>albert</user>
				<text>this is a comment, only the last 3 are returned</text>
				<timestamp>1219267191</timestamp>
			</comment>
		</update>
	</result>