Blipfoto API

get/contributor

This resource returns the profile information for a given contributor, including their biography and list of subscribed journals.

URL

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

Parameters

Parameter Description Required?
user_name A comma-separated list of usernames. Yes
data A comma separated list of values for the data you wish to retrieve. The available values are: Yes
display_name The contributor's display name
journal_title The contributor's journal title
biography The contributor's biography (may contain HTML)
country The country in which the contributor is based
avatar The URL of the contributor's avatar
last_entry_date The date of the contributor's last entry in YYYY-MM-DD format
sign_up_date The contributor's sign up date in YYYY-MM-DD format
subscriptions Array of display_name and journal_title items for each subscription
can_subscribe Returns 1 if the authenticated user can subscribe to the user's journal, otherwise 0.
can_unsubscribe Returns 1 if the authenticated user can unsubscribe from the user's journal, otherwise 0.

Response data

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

Example

The following request:

http://api.blipfoto.com/get/contributor/?api_key=4c297fc904&display_name=gbradley&data=country,last_entry_date,subscriptions

will give this response:

<?xml version="1.0" encoding="UTF-8"?>
<blipapi>
	<version>2</version>
	<request_id></request_id>
	<error></error>
	<data>
		<item>
			<country>United Kingdom</country>
			<last_entry_date>2009-05-29</last_entry_date>
			<subscriptions>
				<subscription>
					<display_name>missing</display_name>
					<journal_title>Somethings Missing</journal_title>
				</subscription>
				<subscription>
					<display_name>made</display_name>
					<journal_title>Anne-Madelen</journal_title>
				</subscription>
				<subscription>
					<display_name>farsidehues</display_name>
					<journal_title>Hues from the far side</journal_title>
				</subscription>
			</subscriptions>
		</item>
	</data>
</blipapi>

Note that some fields may not be populated due to user preferences.