get/entry

Parameters

Parameter	Description	Required?
display_name	The display name(s) of the user whose entries you wish to return. You may specify multiple display names by separating them with commas. e.g. display_name=joe,g	No
date	The date(s) of the entries you wish to return, in YYYY-MM-DD format. You may specify multiple dates by separating them with commas. e.g. date=2008-05-06 Alternatively, you can use the latest keyword to return the latest entry from the specified user(s). e.g. date=latest	No
entry_id	Rather than providing display_name and date parameters, you can instead provide multiple entry_id values. Again, separate them with commas. e.g. entry_id=44865,44787	No
data	A comma separated list of values for the data you wish to retrieve. The available values are:	Yes
	display_name The display name of the entry's owner journal_title The journal title of the entry's owner entry_id The unique entry ID date The entry date in YYYY-MM-DD format title The entry title description The entry description image The URL of the entry's image image_width The entry's image width in pixels image_height The entry's image height in pixels large_image The URL of the entry's large image. If not available, an empty string will be returned. large_image_width The large image's width in pixels. If not available, 0 is returned. large_image_height The large image's height in pixels. If not available, 0 is returned. rating The entry rating (1-5) tags The entry's tags (returned as an array) views The number of views the entry has had thumbnail The URL of the entry's colour thumbnail permalink The URL of the entry exif An array of the image's EXIF data. Specify the EXIF fields you require by separating any of the following values with a vertical pipe, and prefixing the list with a colon: camera model exposure aperture focal iso e.g. exif:focal|model|iso comments An array of the entry's comments. You must specify the fields you require by separating any of the following values with a vertical pipe, and prefixing the list with a colon: author date comment e.g. comments:author|comment allow_comment If comments can be added to the entry, this value is set to 1, or 0 if new comments are disabled. next_entry_id The ID of the next entry in the owner's journal. An empty string is returned if there is no such entry. prev_entry_id The ID of the previous entry in the owner's journal. An empty string is returned if there is no such entry. can_subscribe Returns 1 if the authenticated user can subscribe to the entry's journal, otherwise 0. can_unsubscribe Returns 1 if the authenticated user can unsubscribe from the entry's journal, otherwise 0. can_favourite Returns 1 if the authenticated user can favourite the entry, otherwise 0. e.g. data=title,desc,thumbnail,exif:focal|iso Note that if author is requested, the author field is populated with the commentor's username, and a guest field is added to denote whether or not the commentor was a guest.

Response data

The data object is an array of objects containing the information that was requested.

Example

The following request:

http://api.blipfoto.com/get/entry/?api_key=4c297fc904&display_name=g,joe&entry_date=2009-02-06&data=user_name,thumbnail,date,views,title,description,exif:iso|aperture

will give this response:

<?xml version="1.0" encoding="UTF-8"?>
<blipapi>
	<version>2</version>
	<request_id></request_id>
	<error></error>
	<data>
		<item>
			<display_name>G</display_name>
			<date>2009-02-06</date>
			<title>A Quiet Friday Night</title>
			<description><![CDATA[Tonight we're baby sitting the lovely Bella.  Right now she's
tucked up upstairs after an evening of playing, reading and a quick 
<a href='http://www.youtube.com/watch?v=blrl4wC-vsk'>Miffy</a> video on the iPhone.
All quiet on the western front......and The Wonder Dog is lying beside us on the sofa. A contented
Friday evening.]]></description>
			<views></views>
			<thumbnail>
				http://www.blipfoto.com/thumbs/9/2009/big/color/1963367765498cba6cdbc00
				2.14174956.jpeg
			</thumbnail>
			<exif>
				<iso>400</iso>
				<aperture>f/4.5</aperture>
			</exif>
		</item>
		<item>
			<display_name>Joe</display_name>
			<date>2009-02-06</date>
			<title>Blue sky thinking</title>
			<description>If you could turn my mind inside out, this is pretty much what you'd see.
My goal in life? Pan right, tilt up.</description>
			<views>456</views>
			<thumbnail>
				http://www.blipfoto.com/thumbs/2/2009/big/color/102936164498c61ee6b503
				8.30686958.jpeg
			</thumbnail>
			<exif>
				<iso>100</iso>
				<aperture>f/8.0</aperture>
			</exif>
		</item>
	</data>
</blipapi>

Note that some fields may not be populated due to user preferences (such as views above).