cetteup/unsplash

Unofficial PHP wrapper to access the Unsplash API

v1.1 2020-06-27 09:25 UTC

Requires

• php: >=5.6.0
• ext-json: *
• guzzlehttp/guzzle: ~6.2

Requires (Dev)

• phpunit/phpunit: 4.3.*

MIT

README

An unofficial PHP wrapper to access the Unsplash API, focused on API call efficiency and ease of use.

Note: This wrapper only supports public actions.

Installation

Unsplash-PHP uses Composer. To use it, require the library

composer require cetteup/unsplash

Usage

Configuration

Before you can start making calls to the API, you need to configure the client with your application ID.

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');

API methods

Please refer to the official documentation for more detailed information on the response structures.

Cetteup\Unsplash\HttpClient->user_find($username)

Retrieve public details on a given user.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$user = $unsplash->user_find('cetteup');

Cetteup\Unsplash\HttpClient->user_portfolio_link($username)

Retrieve a single user’s portfolio link.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$link = $unsplash->user_portfolio_link('cetteup');

Cetteup\Unsplash\HttpClient->user_photos($username, $page, $per_page, $order_by, $stats, $resolution, $quantity, $orientation)

Get a list of photos uploaded by a user.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$photos = $unsplash->user_photos('cetteup', 2, 30, 'oldest');

Cetteup\Unsplash\HttpClient->user_likes($username, $page, $per_page, $order_by, $orientation)

Get a list of photos liked by a user.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$photos = $unsplash->user_likes('cetteup', 2, 20, 'popular');

Cetteup\Unsplash\HttpClient->user_collections($username, $page, $per_page)

Get a list of collections created by a user.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$collections = $unsplash->user_collections('jlantunez', 3, 5);

Cetteup\Unsplash\HttpClient->user_statistics($username, $resolution, $quantity)

Retrieve the consolidated number of downloads, views and likes of all user’s photos, as well as the historical breakdown and average of these stats in a specific timeframe.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$collections = $unsplash->user_statistics('cetteup', 'days', 10);

Cetteup\Unsplash\HttpClient->photo_all($page, $per_page, $order_by)

Get a single page from the list of all photos.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$photos = $unsplash->photo_all(2, 30, 'oldest');

Cetteup\Unsplash\HttpClient->photo_find($id)

Retrieve a single photo.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$photo = $unsplash->photo_find('54t5rivyAiI');

Cetteup\Unsplash\HttpClient->photo_random($params)

Retrieve a single random photo, given optional filters.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$photo = $unsplash->photo_random(['orientation' => 'portrait']);

Cetteup\Unsplash\HttpClient->photo_statistics($id, $resolution, $quantity)

Retrieve total number of downloads, views and likes of a single photo, as well as the historical breakdown of these stats in a specific timeframe.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$stats = $unsplash->photo_statistics('54t5rivyAiI', 'days', 14);

Cetteup\Unsplash\HttpClient->photo_download($id)

Track a photo download.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$unsplash->photo_download('54t5rivyAiI');

Cetteup\Unsplash\HttpClient->search_photos($search, $page, $per_page, $order_by, $content_filter, $collections, $color, $orientation)

Get a single page of photo results for a query.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$results = $unsplash->search_photos('cats', 5, 30);

Cetteup\Unsplash\HttpClient->search_collections($search, $page, $per_page)

Get a single page of collection results for a query.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$results = $unsplash->search_collections('dogs', 10, 25);

Cetteup\Unsplash\HttpClient->search_users($search, $page, $per_page)

Get a single page of user results for a query.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$results = $unsplash->search_users('photography', 1, 15);

Cetteup\Unsplash\HttpClient->collection_all($page, $per_page)

Get a single page from the list of all collections.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$collections = $unsplash->collection_all(10, 30);

Cetteup\Unsplash\HttpClient->collection_featured($page, $per_page)

Get a single page from the list of featured collections.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$collections = $unsplash->collection_featured(2, 10);

Cetteup\Unsplash\HttpClient->collection_find($id)

Retrieve a single collection.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$collection = $unsplash->collection_find(1121542);

Cetteup\Unsplash\HttpClient->collection_photos($id, $page, $per_page, $orientation)

Retrieve a collection’s photos.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$photos = $unsplash->collection_photos(1121542, 1, 10, 'squarish');

Cetteup\Unsplash\HttpClient->collection_related($id)

Retrieve a list of related collections.

Note: You need to instantiate an httpclient object first

Arguments

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$collections = $unsplash->collection_related(1121542);

Cetteup\Unsplash\HttpClient->stats_total()

Get a list of stats for all of Unsplash.

Note: You need to instantiate an httpclient object first

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$stats = $unsplash->stats_total();

Cetteup\Unsplash\HttpClient->stats_month()

Get the overall Unsplash stats for the past 30 days.

Note: You need to instantiate an httpclient object first

Example

$unsplash = new Cetteup\Unsplash\HttpClient('YOUR APPLICATION ID');
$stats = $unsplash->stats_month();