get/search

This resource allows you to retrieve entry listings by submitting a search query. The search terms available are the same as the terms available via the search facility on Blipfoto.com; this includes seaching by tags, contributor, date, EXIF data and much more.

URL

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

Version 1
Version 2

Parameters

Parameter	Description	Required?
`query`	The search phrase (ensure the phrase is URL encoded).	Yes
`max`	The maximum number of entries to return. By default the limit of 90 is returned.	No
`size`	The thumbnail size, `big` (124px, default) or `small` (48px).	No
`color`	The thumbnail color, `color` (default) or `gray`.	No
`test`	By default, the API does not include results from test accounts. When in the testing phase of your application, pass `1` 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
`user_name`	The contributor's username	String
`journal_name`	The contributor's journal name	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/search/?api_key=4c297fc904&query=by+Joe&max=2

might result in the following response:

<?xml version="1.0" encoding="UTF-8"?>
<blipapi>
	<request_id></request_id>
	<error></error>
	<data>
		<item>
			<user_name>Joe</user_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/Joe-2009-3-10</permalink>
		</item>
		<item>
			<user_name>Joe</user_name>
			<journal_name>Joe Blogs</journal_name>

			<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/Joe-2009-3-9</permalink>
		</item>
	</data>
</blipapi>

Blipfoto API

get/search

URL

Parameters

Response data

Example