Blipfoto API

Breaking changes - legacy APIs will be disabled 6th January, 2014

Please note - the v1 and v2 APIs will be permanently disabled on Monday the 6th of January, 2014. If your app uses these APIs, you should migrate to v3 before this date to ensure your app continues to function correctly.

Migrating your app to v3 will require some fundamental changes, including updating resource URLs and handling the new authentication flow. You can read more about migration at the new developer site:

https://developer.blipfoto.com/docs/v3/migration

For further help with the v3 API, ask a question on the API forum or get in touch.

get/favourites

This resource returns entries which have been favourited by the authenticated user. The user must be a member, otherwise an error will be returned.

URL

http://api.blipfoto.com/get/favourites/
  • Version 2

Parameters

This resource also requires the API Key and Authentication parameters.

Parameter Description Required?
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

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/favourites/?api_key=4c297fc904&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>