get/view

This resource returns entry listings based on a certain view. These views correspond to the views on the homepage of Blipfoto.com.

URL

http://api.blipfoto.com/get/view/

Version 1
Version 2

Parameters

Note that some views may require the authentication parameters.

Parameter	Description	Required?
`view`	The type of view to use. This can be any one of the following: `date` `spotlight` `rated` `random` `favourites` `subscribed` `me` If the `group_id` parameter is supplied, the view can be one of: `added` `date` `upload` `random`	Yes
`max`	The maximum number of entries to return. The default is 12, while the limit is 90.	No
`size`	The thumbnail size, `big` (124px, default) or `small` (48px).	No
`color`	The thumbnail color, `color` (default) or `gray`.	No
`timezone`	When the `view` parameter is set to `date`, only images dated equal to or earlier than the current date are returned. The current date is determined using GMT by default; you may adjust this to your user's local time zone by passing an integer value (`-12` to `12`) to this parameter.	No
`test`	By default, the API does not include results from test accounts. When in the testing phase of your application, pass '1' to this parameter to include results from your test account.	No

Response data

The data object is an array of objects containing the following:

Name	Description	Data type
`display_name`	The contributor's display name	String
`journal_title`	The contributor's journal title	String
`entry_id`	The entry's unique identifier	String
`thumbnail`	The URL of the entry's thumbnail	String
`date`	The entry date in YYYY-MM-DD format	String
`title`	The entry title	String
`permalink`	The URL of the entry	String

Example

The following request:

http://api.blipfoto.com/get/view/?api_key=4c297fc904&view=random&max=2

might result in the following response:

<?xml version="1.0" encoding="UTF-8"?>
<blipapi>
	<version>2</version>
	<request_id></request_id>
	<error></error>
	<data>
		<item>
			<display_name>Joe</display_name>
			<journal_name>Joe Blogs</journal_name>
			<entry_id>264538</entry_id>
			<thumbnail>
				http://www.blipfoto.com/thumbs/2/2009/big/color/205636222249b6da74c1f232
				.13998171.jpeg
			</thumbnail>
			<date>2009-03-10</date>
			<title>Repose</title>
			<permalink>http://www.blipfoto.com/entry/264538</permalink>
		</item>
		<item>
			<display_name>Joe</display_name>
			<journal_title>Joe Blogs</journal_title>
			<entry_id>263889</entry_id>
			<thumbnail>
				http://www.blipfoto.com/thumbs/2/2009/big/color/203157200849b56b1287dc24
				.87338624.jpeg
			</thumbnail>
			<date>2009-03-09</date>
			<title>Mother</title>
			<permalink>http://www.blipfoto.com/entry/263889</permalink>
		</item>
	</data>
</blipapi>

Blipfoto API

get/view

URL

Parameters

Response data

Example